Docker中执行activator clean compile stage构建Playframework项目无法完成如何解决

核心错误修正 #

你当前Dockerfile的指令使用逻辑错误：CMD是容器启动时执行的命令，你将activator clean stage放在CMD中，会导致每次启动容器都要重新执行全量编译，而非镜像构建阶段一次性完成编译，这是编译流程始终无法结束的最常见原因。
修正方案：将编译逻辑移到RUN指令，镜像构建阶段完成编译，容器启动时直接运行打包好的可执行文件即可，优化后的Dockerfile参考：

FROM openjdk:8
ENV PROJECT_HOME /usr
RUN mkdir -p $PROJECT_HOME/activator $PROJECT_HOME/app
WORKDIR $PROJECT_HOME/activator
RUN wget https://downloads.typesafe.com/typesafe-activator/1.3.2/typesafe-activator-1.3.2.zip && \
unzip typesafe-activator-1.3.2.zip
ENV PATH $PATH:$PROJECT_HOME/activator/activator-1.3.2
ENV PATH $PATH:$PROJECT_HOME/app/target/universal/stage/bin

# 提前拷贝构建配置文件，缓存依赖层，避免每次代码变更都重新拉取所有依赖
COPY build.sbt $PROJECT_HOME/app/
COPY project/ $PROJECT_HOME/app/project/
WORKDIR $PROJECT_HOME/app
# 提前拉取依赖，缓存该层加快后续构建速度
RUN activator update

# 拷贝全量项目代码
COPY . $PROJECT_HOME/app
# 构建阶段完成编译打包，同时分配足够JVM内存避免OOM
RUN activator -J-Xmx4G -J-Xms2G clean stage

# 容器启动直接运行编译好的服务，替换my-app为你自己项目的名称（即target/universal/stage/bin下的可执行文件名）
CMD ["my-app", "-Dplay.http.secret.key=替换为你自己的业务密钥"]
EXPOSE 9000 8888

其他常见问题排查 #

• 资源分配不足：生产模式编译需要占用更多内存CPU资源，Docker默认分配的资源可能无法满足需求，Docker Desktop用户可以在设置中将内存分配调整到至少4G、CPU至少2核，服务器环境可以在执行docker build时添加资源限制参数。
• 依赖拉取超时：activator默认拉取依赖使用国外源，网络环境差会导致依赖拉取卡住，可以在项目根目录下新建conf/repositories文件，添加国内maven/ivy镜像源加快拉取速度。
• 版本不兼容：你使用的activator 1.3.2版本仅适配Play 2.3.x及更低版本，如果你的Play版本高于2.4.x，会出现兼容性问题导致编译死锁或失败，高版本Play建议直接使用sbt构建，无需使用activator。
• 编译进度不可见误以为卡住：执行docker build时添加--progress plain参数，可查看完整的编译日志，确认是真的卡住还是后台正在拉取依赖或执行编译。

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