Hawkbit服务运行数小时后故障：数据库连接丢失问题排查

1. 先检查MySQL卷的持久化配置 #

• 确认docker-compose里MySQL的卷挂载路径是否正确：MySQL容器默认数据存储路径是/var/lib/mysql，如果挂载路径写错（比如写成/var/mysql），容器重启后会重新初始化空数据库，自然找不到hawkbit库。正确配置示例：

  services:
    mysql:
      image: mysql:8.0
      volumes:
        - mysql_data:/var/lib/mysql  # 必须挂载到容器内的/var/lib/mysql
      environment:
        MYSQL_ROOT_PASSWORD: your_root_pass
        MYSQL_DATABASE: hawkbit
        MYSQL_USER: hawkbit_user
        MYSQL_PASSWORD: hawkbit_pass
  volumes:
    mysql_data:  # 用命名卷，避免主机路径权限坑
  

• 如果用主机目录挂载（比如./mysql_data:/var/lib/mysql），要检查权限：容器内MySQL用户的UID通常是999，执行chown -R 999:999 ./mysql_data修复权限，否则MySQL启动时读写不了数据，会重新初始化新库。

2. 查MySQL容器异常重启的原因 #

• 看MySQL容器日志：执行docker logs <mysql_container_name>，找重启前的报错，常见原因：
  • 磁盘空间满：MySQL会被强制重启，重启后可能加载不了原有数据
  • 内存不足：宿主机OOM Killer杀死MySQL进程，导致异常重启
  • 数据文件损坏：异常断电/重启导致InnoDB文件损坏，MySQL启动时自动初始化新库
• 检查宿主机资源：用df -h看磁盘使用率，free -m看内存，确保资源充足。

3. 核对Hawkbit的数据库连接配置 #

• 确认JDBC URL加了autoReconnect=true参数，不然MySQL断开后Hawkbit不会主动重连，示例：

  jdbc:mysql://mysql:3306/hawkbit?useSSL=false&autoReconnect=true&serverTimezone=UTC
  

• 检查连接池配置：比如HikariCP要加validationTimeout和testOnBorrow参数，确保连接失效时能自动获取新连接。

4. 验证卷的完整性 #

• 备份现有卷数据后，执行docker volume inspect mysql_data查看卷的实际存储路径，进去检查有没有hawkbit相关的文件（比如hawkbit/目录、.frm/.ibd文件）。如果没有，说明卷没正确持久化数据，得重新配置挂载。
• 别用临时卷：确保docker-compose里MySQL的卷不是tmpfs类型，临时卷容器重启就丢数据。

5. 测试复现验证 #

• 手动重启MySQL容器，看Hawkbit是否立刻报错。如果是，说明是卷配置或MySQL初始化的问题；如果数小时后才出问题，大概率是MySQL因资源不足或其他原因异常重启，且重启后加载不了原有数据。

内容的提问来源于stack exchange，提问作者sydrgt