ljwx-health/archive/2025/DEPLOYMENT_VERIFICATION.md

LJWX Health - K3s 部署验证报告

验证时间: 2025-12-21 21:02 验证人: Claude Code 环境: K3s EU (ljwx-health namespace)

---

✅ 部署状态总结

应用服务状态

Service	Status	Replicas	Image Version	健康检查
ljwx-health-boot	✅ Running	1/1	dev-20251221-092518	✅ Ready
ljwx-health-admin	✅ Running	1/1	dev-20251221-092518	✅ Ready
ljwx-health-bigscreen	⚠️ Disabled	0/0	dev-20251221-092518	代码问题（已禁用）

基础设施服务

Service	Namespace	Status	连接验证
MySQL	infra	✅ Running	✅ 成功 (94 张表)
Redis	infra	✅ Running	✅ 成功

Ingress 配置

域名	后端服务	TLS	状态
health-admin.lingjingwanxiang.cn	ljwx-health-admin:80	✅	已配置
health-dashboard.lingjingwanxiang.cn	ljwx-health-bigscreen:5225	✅	已配置（服务未启用）

Ingress Class: traefik Address: 173.212.254.252, 84.247.162.131

---

✅ Flyway 迁移验证

迁移历史

mysql> SELECT * FROM flyway_schema_history ORDER BY installed_rank;
+----------------+---------+-------------------------------------+------+--------+-------------+
| installed_rank | version | description                         | type | success| installed_on|
+----------------+---------+-------------------------------------+------+--------+-------------+
| 1              | 1.0.3   | create weight cache table           | SQL  | 1      | 2025-12-21  |
| 2              | 1.0.4   | optimize health baseline for userid | SQL  | 1      | 2025-12-21  |
+----------------+---------+-------------------------------------+------+--------+-------------+

数据库状态

• 数据库: ljwx_health
• 表总数: 94 张
• 关键表验证: ✅ 所有核心表已创建
  • sys_user, sys_user_org, sys_user_position, sys_user_role
  • t_device_user
  • t_health_* (健康数据相关表)
  • t_user_health_data (用户健康数据主表)

Flyway 警告说明

警告信息:

ERROR --- [main] o.f.core.internal.command.DbMigrate :
Schema `ljwx_health` has version 1.0.4, but no migration could be resolved in the configured locations !

原因:

• Docker 镜像中未包含完整的迁移脚本（仅有 V1.0.3 和 V1.0.4）
• 数据库使用基线 SQL（V20251218_001__baseline.sql）手动初始化

影响:

• ⚠️ 不影响应用运行 - 数据库已有所有必需的表
• ✅ 应用启动正常，所有功能可用

建议:

• 修复 Maven 构建配置，确保迁移脚本打包到 JAR
• 或继续使用基线 SQL + 增量迁移的方式

---

✅ 应用启动日志验证

关键日志检查

✅ Started LjwxBootAdminApplication in 42.89 seconds (process running for 44.522)
✅ Tomcat started on port 9998 (http) with context path '/'
✅ Scheduler quartzScheduler_$_NON_CLUSTERED started
✅ Redis缓存高性能查询服务已启用
✅ SaTokenDao 载入成功: cn.dev33.satoken.dao.SaTokenDaoRedisJackson
✅ Redis缓存预热完成，耗时: 201ms

错误检查

过滤条件: 排除 Flyway 警告和定时任务框架日志

结果: ✅ 无运行时错误

• 无 Exception
• 无 SQLSyntaxErrorException（表不存在）
• 无 Redis 连接错误
• 无 MySQL 连接错误

---

✅ 环境配置验证

Redis 配置（已修复）

问题: 初始配置使用了错误的环境变量名

• 应用配置期望: REDIS_HOST, REDIS_PORT, REDIS_DB
• 初始部署使用: SPRING_REDIS_HOST, SPRING_REDIS_PORT, SPRING_REDIS_DATABASE

修复: ✅ 已更新 k3s-eu.yaml 并重新部署

当前配置:

env:
  - name: REDIS_HOST
    value: "redis-lb.infra.svc.cluster.local"
  - name: REDIS_PORT
    value: "6379"
  - name: REDIS_DB
    value: "1"

验证: ✅ Redis 连接成功，缓存服务正常

MySQL 配置

env:
  - name: SPRING_DATASOURCE_URL
    value: "jdbc:mysql://mysql.infra.svc.cluster.local:3306/ljwx_health?..."
  - name: SPRING_DATASOURCE_DRIVER_CLASS_NAME
    value: "com.mysql.cj.jdbc.Driver"

验证: ✅ MySQL 连接成功，数据库操作正常

---

⚠️ 已知问题

1. ljwx-bigscreen 服务问题（已禁用）

问题:

• SQLAlchemy 2.0 兼容性问题
• 健康检查失败（500 Internal Server Error）

错误详情:

sqlalchemy.exc.ArgumentError: Textual SQL expression 'SELECT 1' should be
explicitly declared as text('SELECT 1')

NameError: name 'system_logger' is not defined

影响: health-dashboard.lingjingwanxiang.cn 暂时无法访问

解决方案:

• 修复 ljwx-bigscreen 代码兼容性问题
• 更新健康检查逻辑

当前状态: 已缩容至 0 副本（kubectl scale deployment ljwx-health-bigscreen --replicas=0）

2. Flyway 迁移脚本打包问题

问题: Maven 构建时迁移脚本未包含在 JAR 中

临时方案: ✅ 使用基线 SQL 手动初始化（已完成）

永久方案:

• 检查 pom.xml 资源配置
• 或启用独立的 Flyway Migration Job

---

🎉 部署成功验证

核心功能验证

功能	状态	说明
应用启动	✅	42.89 秒启动完成
数据库连接	✅	MySQL infra 连接正常
Redis 缓存	✅	缓存预热完成
定时任务	✅	Quartz 调度器运行
认证服务	✅	SaToken + Redis 正常
API 接口	✅	Actuator 端点可访问
Ingress 路由	✅	已配置 HTTPS 域名

访问方式

通过 Ingress（需配置 DNS）:

• Admin 前端: https://health-admin.lingjingwanxiang.cn
• Dashboard: https://health-dashboard.lingjingwanxiang.cn (待修复)

通过端口转发:

# Backend API
kubectl port-forward -n ljwx-health svc/ljwx-health-boot 9998:9998
curl http://localhost:9998/actuator/health

# Frontend Admin
kubectl port-forward -n ljwx-health svc/ljwx-health-admin 8080:80
# 访问: http://localhost:8080

---

📋 后续任务

高优先级

• 修复 ljwx-bigscreen SQLAlchemy 兼容性问题
• 配置 DNS 解析（health-admin.lingjingwanxiang.cn）
• 验证通过 Ingress 的 HTTPS 访问

中优先级

• 修复 Flyway 迁移脚本打包问题
• 添加应用监控（Prometheus metrics）
• 配置日志收集（Loki）

低优先级

• 性能测试和优化
• 配置自动扩容（HPA）
• 添加备份策略

---

📊 部署总结

成功完成

✅ 清理旧资源 ✅ 部署 Redis 到 infra namespace ✅ 创建一键部署脚本（已包含所有组件） ✅ 配置 Ingress（HTTPS + TLS） ✅ 复用 infra 的 MySQL 和 Redis ✅ 执行数据库基线迁移（94 张表） ✅ 修复 Redis 环境变量配置 ✅ 验证应用无运行时错误

部分完成

⚠️ ljwx-bigscreen 需要代码修复 ⚠️ Flyway 迁移脚本打包问题（不影响运行） ⚠️ DNS 配置待完成

---

验证结论: 🎉 ljwx-health 应用已成功部署到 K3s，核心功能正常，无运行时错误！