Spring Boot整合MySQL部署Docker启动失败问题排查

核心原因分析 #

org.springframework.beans.factory.NoSuchBeanDefinitionException报错本质是Spring容器未扫描到IpBlockedAddressesRepository，无法生成对应Bean，导致依赖注入链断裂。本地运行正常但Docker环境出错，大概率是包扫描范围配置、镜像构建代码遗漏、容器环境下Spring配置差异这几类问题导致。

逐一排查与修复步骤 #

1. 检查Repository注解与包扫描范围 #

• 确认IpBlockedAddressesRepository是否继承了Spring Data的JpaRepository/CrudRepository（Spring Data会自动为这类接口生成Bean，无需额外加@Repository；如果是自定义实现类则必须标注@Repository）
• 检查Spring Boot启动类的@SpringBootApplication注解，若Repository所在包不在启动类的子包范围内，需手动指定扫描路径：

  @SpringBootApplication(scanBasePackages = "com.example.favouritePlaceInTheWorld")
  // 可单独指定JPA相关扫描路径，更精准
  @EnableJpaRepositories(basePackages = "com.example.favouritePlaceInTheWorld.repository")
  @EntityScan(basePackages = "com.example.favouritePlaceInTheWorld.entity")
  public class YourApplication {
      public static void main(String[] args) {
          SpringApplication.run(YourApplication.class, args);
      }
  }
  

2. 验证Docker镜像构建完整性 #

• 检查Dockerfile是否正确打包了最新代码，示例正确写法：

  FROM openjdk:17-jdk-slim
  WORKDIR /app
  # 确保target目录下的jar包是执行mvn clean package后生成的最新包
  COPY target/your-app-jar-name.jar app.jar
  EXPOSE 8080
  ENTRYPOINT ["java", "-jar", "app.jar"]
  

• 构建镜像前先执行mvn clean package，避免缓存旧代码导致镜像内容不全

3. 检查容器环境下的Spring配置 #

• 确认application.yml中JPA配置正确读取了环境变量，且指定了数据库名称（这是容易忽略的点，缺失会导致JPA初始化失败）：

  spring:
    datasource:
      url: jdbc:mysql://${MYSQL_HOST:localhost}:${MYSQL_PORT:3306}/your_database_name?useSSL=false&serverTimezone=UTC
      username: ${MYSQL_USER:root}
      password: ${MYSQL_PASSWORD:}
    jpa:
      hibernate:
        ddl-auto: update
      show-sql: true
  

4. 确认MySQL容器与网络连通性 #

• 执行docker exec app ping mysqldb，检查应用容器能否连通MySQL容器
• 进入MySQL容器，执行show databases;确认目标数据库已创建
• 检查MySQL用户权限，确保root用户允许远程访问（本地可能用localhost权限，Docker环境需要%权限）：

  GRANT ALL PRIVILEGES ON your_database_name.* TO 'root'@'%' IDENTIFIED BY '12345678';
  FLUSH PRIVILEGES;
  

5. 查看容器完整启动日志 #

• 执行docker logs app，排查是否有数据库连接失败等前置错误（这类错误会导致JPA初始化失败，进而无法生成Repository Bean）

验证流程 #

1. 修复后重新构建镜像：docker build -t app .
2. 重新启动容器：docker run -p 9000:8080 --name app --net spring-net -e MYSQL_HOST=mysqldb -e MYSQL_USER=root -e MYSQL_PASSWORD=12345678 -e MYSQL_PORT=3306 app
3. 查看日志确认启动正常，或访问http://localhost:9000验证应用可用性

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