Docker容器中Tomcat成功部署WAR文件但Spring MVC注解应用无法启动求助

针对你遇到的这个问题——WAR包在Docker Tomcat中部署解压成功，但Spring MVC应用本身无法启动，而本地Eclipse和外部纯净Tomcat环境都能正常运行，我整理了以下针对性的排查步骤：

1. 检查容器内WAR文件/目录的权限问题 #

Docker挂载本地目录时，容易出现文件权限不匹配的情况：Tomcat容器通常以tomcat用户运行，而本地挂载的文件/目录可能是root权限，导致Tomcat无法读取应用文件。

• 进入容器查看权限：

  docker exec -it <你的tomcat容器ID/名称> ls -l /usr/local/tomcat/webapps/ROOT
  

• 如果发现文件所有者是root，可以尝试：
  • 在本地修改./zzz目录的权限：chmod -R 755 ./zzz
  • 或者在docker-compose的tomcat服务中指定运行用户：user: "tomcat"（需要确保容器内有该用户）

2. 验证Spring初始化类的存在与加载 #

因为你的应用基于注解开发，没有web.xml，必须通过WebApplicationInitializer实现类（或Spring Boot的SpringBootServletInitializer）来启动Spring容器。

• 进入容器解压WAR包检查：

  docker exec -it <容器ID> unzip -l /usr/local/tomcat/webapps/ROOT.war | grep "WebApplicationInitializer\|SpringBootServletInitializer"
  

• 确认对应的初始化类存在于WEB-INF/classes目录下，若缺失则说明打包过程有问题，需要检查Maven/Gradle的打包配置。

3. 开启详细日志排查Spring启动细节 #

当前Catalina日志只显示了Tomcat部署成功的信息，没有Spring容器初始化的日志，无法定位内部错误：

• 修改Tomcat的日志配置，将Spring相关日志级别改为DEBUG：
  1. 本地创建logging.properties文件，添加：

     org.springframework.level = FINEST
     

  2. 在docker-compose的tomcat服务volumes中添加：

     - ./logging.properties:/usr/local/tomcat/conf/logging.properties
     

• 重启容器后，查看localhost.log或catalina.out，就能看到Spring容器启动的详细过程，包括可能的初始化失败原因（如数据源连接失败、Bean创建异常等）。

4. 检查环境变量与数据库连接配置 #

注意到你在docker-compose中配置了数据库相关环境变量，需要确认：

• 环境变量格式是否正确：你的DATABASE_URL写的是jdbc:mysql:/xxxxx，标准格式应为jdbc:mysql://<db-host>:<port>/<db-name>，少了//会导致数据库连接失败。
• 数据库是否就绪：depends_on仅保证启动顺序，不保证数据库完成初始化。可以给db服务添加健康检查，确保Tomcat在数据库就绪后启动：

  db:
    image: mysql:5.7
    environment:
      # 你的环境变量
    volumes:
      - .data:/var/lib/mysql
    ports:
      - "3309:3306"
    healthcheck:
      test: ["CMD", "mysqladmin", "ping", "-h", "localhost", "-u", "root", "-p${MYSQL_ROOT_PASSWORD}"]
      interval: 5s
      timeout: 5s
      retries: 5
  tomcat:
    # 你的配置
    depends_on:
      db:
        condition: service_healthy
  

5. 调整挂载方式避免目录冲突 #

你当前挂载的是整个webapps目录，可能存在旧的解压后的ROOT目录与新WAR包冲突的情况：

• 改为直接挂载WAR文件而非目录，让Tomcat自动处理解压：

  volumes:
    - ./zzz/ROOT.war:/usr/local/tomcat/webapps/ROOT.war
  

• 挂载前先删除本地./zzz目录下的ROOT文件夹，避免旧代码干扰。

6. 验证Tomcat版本与依赖兼容性 #

确认本地正常运行的Tomcat版本与Docker中使用的tomcat:8-jre8-openjdk是否一致：

• Tomcat 8.x的小版本差异（如8.0 vs 8.5）可能导致Servlet API兼容性问题，而Spring MVC对Servlet API版本有要求。
• 检查应用依赖的spring-webmvc版本是否与Tomcat 8支持的Servlet 3.1规范兼容。

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