Spring Boot 服务依赖 MySQL 启动失败解决方案

当 Spring Boot 服务因 MySQL 依赖启动失败时，可以按照以下步骤排查和解决问题：

常见错误原因及解决方案

1. 数据库连接配置错误

# application.properties 检查以下配置
spring.datasource.url=jdbc:mysql://localhost:3306/your_database?useSSL=false&serverTimezone=UTC
spring.datasource.username=your_username
spring.datasource.password=your_password
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver

2. MySQL 驱动依赖缺失

确保 pom.xml 或 build.gradle 中包含正确的 MySQL 驱动依赖：

<!-- Maven 依赖 -->
<dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
    <version>8.0.28</version> <!-- 使用适合的版本 -->
</dependency>

3. 数据库服务未运行

• 检查 MySQL 服务是否已启动：sudo systemctl status mysql (Linux) 或服务管理器(Windows)
• 尝试手动连接数据库验证：mysql -u username -p

4. 网络连接问题

• 检查防火墙设置是否阻止了 3306 端口
• 确认数据库地址是否正确（如果是远程数据库）

5. 数据库不存在或权限不足

• 确认数据库名称拼写正确
• 检查用户是否有该数据库的访问权限

高级排查步骤

1. 查看完整错误日志

   • 添加 logging.level.root=DEBUG 到 application.properties 获取更详细日志
   • 检查启动时的完整堆栈跟踪

2. 测试数据库连接

   @SpringBootTest
   class DatabaseConnectionTest {
      @Autowired
      private DataSource dataSource;
   
      @Test
      void testConnection() throws SQLException {
          try (Connection connection = dataSource.getConnection()) {
              assertTrue(connection.isValid(1000));
          }
      }
   }
   

3. 检查时区设置

   • 在连接字符串中添加 serverTimezone 参数
   • 例如：?serverTimezone=UTC

4. SSL 问题

   • 如果不需要 SSL，可以添加 useSSL=false
   • 如果需要 SSL，确保正确配置了证书

常见错误消息及解决方案

• "Access denied for user": 检查用户名/密码，确认用户有访问权限
• "Unknown database": 确认数据库已创建，名称拼写正确
• "Communications link failure": 检查网络连接，MySQL 服务是否运行
• "Public Key Retrieval is not allowed": 在连接字符串添加 allowPublicKeyRetrieval=true

如果问题仍未解决，请提供具体的错误消息以便更精确地诊断问题。