Docker中Tomcat容器无法启动Spring Boot WAR包问题排查

我使用官方最新版Tomcat Docker镜像编写Dockerfile，将Spring Boot的service-2.1.6.war部署到Tomcat的webapps目录。启动容器后看不到Spring Boot应用启动日志，应用无法正常启动，但相同WAR包部署到本地Tomcat服务器，用sudo catalina.sh run就能正常运行。

我的Dockerfile #

##### Use the official Tomcat base image
FROM tomcat:latest

##### Env variable for log path
ENV LOG_PATH=/usr/local/tomcat/logs


##### Copy the WAR file into the webapps directory
COPY service-2.1.6.war /usr/local/tomcat/webapps/

##### Create necessary directories for Tomcat web applications
RUN mv /usr/local/tomcat/webapps.dist/* /usr/local/tomcat/webapps/

##### Set the environment variable for the active Spring profile
#####ENV SPRING_PROFILES_ACTIVE=prod

##### Copy the tomcat-users.xml file to configure the manager users
COPY tomcat-users.xml /usr/local/tomcat/conf/tomcat-users.xml
COPY context.xml /usr/local/tomcat/webapps/manager/META-INF/context.xml

#####Install sudo
RUN apt-get update && apt-get install -y sudo

##### Start Tomcat with sudo
#####CMD ["sudo", "/usr/local/tomcat/bin/catalina.sh", "run"]

容器Tomcat启动日志 #

本地Tomcat启动日志 #

请问问题出在哪里，或是缺少了什么配置？

问题分析与解决方案 #

1. WAR包部署顺序错误 #

你的Dockerfile中先复制WAR包到webapps目录，再执行mv /usr/local/tomcat/webapps.dist/* /usr/local/tomcat/webapps/——这个操作会将官方镜像默认的应用文件（ROOT、manager等）覆盖到webapps目录，虽然不会直接删除WAR包，但会打乱Tomcat的部署优先级，导致WAR包未被正常解压加载。

修复：调整操作顺序
先将webapps.dist的内容迁移到webapps，再复制WAR包，确保WAR包被Tomcat优先扫描：

# 先迁移默认应用
RUN mv /usr/local/tomcat/webapps.dist/* /usr/local/tomcat/webapps/
# 再复制业务WAR包
COPY service-2.1.6.war /usr/local/tomcat/webapps/

2. Spring环境配置未激活 #

你注释掉了ENV SPRING_PROFILES_ACTIVE=prod，如果你的应用依赖生产环境的配置（如数据库连接、中间件地址等），未激活对应Profile会导致应用因配置缺失启动失败，日志可能因初始化崩溃无法正常输出。

修复：取消注释激活Profile

ENV SPRING_PROFILES_ACTIVE=prod

3. 不必要的sudo安装与权限问题 #

官方Tomcat镜像默认使用tomcat用户运行服务，本地需要sudo启动通常是本地文件权限配置问题，容器内无需安装sudo。如果WAR包或配置文件权限不足，会导致Tomcat无法读取或解压WAR包。

修复：添加权限配置（可选）
复制WAR包后，确保文件归属为tomcat用户：

COPY service-2.1.6.war /usr/local/tomcat/webapps/
RUN chown tomcat:tomcat /usr/local/tomcat/webapps/service-2.1.6.war

4. 检查Spring Boot WAR包兼容性 #

确保你的WAR包是为外部Tomcat构建的，而非内嵌Tomcat的可执行WAR：

• Maven项目需在pom.xml中设置<packaging>war</packaging>
• 排除内嵌Tomcat依赖：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-tomcat</artifactId>
    <scope>provided</scope>
</dependency>

• 存在SpringBootServletInitializer子类：

public class ServletInitializer extends SpringBootServletInitializer {
    @Override
    protected SpringApplicationBuilder configure(SpringApplicationBuilder application) {
        return application.sources(YourApplication.class);
    }
}

5. 查看完整应用日志 #

如果以上调整后仍有问题，进入容器查看Tomcat应用日志：

# 进入运行中的容器
docker exec -it <容器ID> /bin/bash

# 查看Tomcat localhost日志（Spring Boot应用启动日志通常在此）
cat /usr/local/tomcat/logs/localhost.log

# 查看应用自身日志（若应用有自定义日志路径）
cat /usr/local/tomcat/webapps/service-2.1.6/WEB-INF/logs/*.log

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