Campus-Imaotai项目部署时数据库表缺失问题分析

问题现象

在使用docker-compose一键部署Campus-Imaotai项目时，系统启动过程中抛出异常，提示Table 'campus_imaotai.sys_config' doesn't exist错误。该错误发生在Spring Boot应用启动阶段，当系统尝试访问sys_config表时发现该表不存在。

错误分析

从日志中可以清晰地看到，应用启动时尝试执行以下SQL查询：

SELECT config_id,config_name,config_key,config_value,config_type,group_code,remark,create_time,create_user,update_time,update_user,del_flag 
FROM sys_config 
WHERE del_flag=0

但MySQL数据库返回错误，表明campus_imaotai.sys_config表不存在。这通常意味着：

1. 数据库初始化不完整，SQL脚本未正确执行
2. 数据库版本不兼容，导致表结构创建失败
3. 数据库连接配置错误，连接到了错误的数据库实例

解决方案

根据项目维护者的建议和实际经验，解决此问题的方法包括：

1. 使用正确的MySQL版本：明确要求使用MySQL 5.7版本，新版本可能存在兼容性问题

2. 完整导入数据库脚本：

   • 确保使用的SQL脚本是最新版本
   • 检查SQL脚本是否包含创建sys_config表的语句
   • 确认脚本执行没有报错

3. 数据库初始化验证：

   • 部署后应登录MySQL验证表结构是否完整
   • 检查campus_imaotai数据库中是否存在所有必要的表

4. 部署环境检查：

   • 确认docker-compose配置中的数据库服务配置正确
   • 检查数据库容器是否正常启动
   • 验证应用容器与数据库容器之间的网络连接

技术细节

该错误发生在Spring Boot应用的初始化阶段，具体是在SysConfigServiceImpl服务加载配置缓存时。系统设计上会在启动时将所有配置项加载到缓存中，因此缺少sys_config表会导致整个应用启动失败。

最佳实践建议

1. 在部署前仔细阅读项目文档，了解数据库要求
2. 使用docker-compose部署时，先单独启动数据库服务并验证
3. 开发环境中可以使用数据库管理工具手动验证表结构
4. 考虑在CI/CD流程中加入数据库健康检查步骤

总结

Campus-Imaotai项目部署时遇到的表缺失问题，核心原因是数据库初始化不完整。通过使用正确的MySQL版本并确保完整执行数据库脚本，可以解决此类问题。这也提醒开发者在部署应用时，数据库初始化和验证是不可忽视的重要环节。