M2芯片Mac构建Scala Play应用Docker镜像时SBT编译卡顿

问题根源 #

卡顿核心原因有两点：

• M2是arm64架构，用Docker buildx构建amd64镜像依赖QEMU模拟x86环境，老版本sbt（1.3.8）与QEMU兼容性差，再加上OpenJDK8在模拟环境下性能劣势，直接导致编译阶段卡住。
• 原Dockerfile未做构建缓存优化，每次构建都要重复拉取依赖、执行编译，进一步放大了性能问题。

具体解决方法 #

1. 升级sbt版本

将sbt从1.3.8升级到1.9.x系列（比如1.9.6），新版本修复了大量跨平台构建的兼容性问题，对QEMU模拟环境的支持更稳定，且完全兼容Scala 2.13.x。

2. 使用预构建的sbt基础镜像

放弃手动安装Scala和sbt，直接使用官方维护的集成镜像，比如hseeberger/scala-sbt:8u372_1.9.6_2.13.12。该镜像已预装好OpenJDK8、Scala 2.13.12和sbt 1.9.6，省去手动安装步骤，且做了性能优化。

3. 优化构建缓存逻辑

原Dockerfile先复制整个项目再编译，导致代码变动时需重新拉取依赖。调整步骤：先复制依赖配置文件，提前执行sbt update和sbt compile缓存依赖层，再复制项目代码，这样依赖层可重复利用。

4. 调整JVM参数缓解模拟压力

在编译阶段设置JVM参数，减少内存占用和GC开销，比如添加ENV JAVA_OPTS="-Xmx2G -XX:+UseParallelGC"，避免模拟环境下内存不足引发卡顿。

5. 改用多阶段构建

将编译阶段与运行阶段分离：编译用带sbt的完整镜像，运行用轻量的OpenJDK8 JRE镜像，既缩小最终镜像体积，也避免运行阶段携带不必要的工具。

修改后的Dockerfile示例 #

# 第一阶段：编译构建
FROM hseeberger/scala-sbt:8u372_1.9.6_2.13.12 AS builder

ENV APP_NAME somebackend-api
ENV APP_VERSION 1.0-SNAPSHOT
ENV JAVA_OPTS="-Xmx2G -XX:+UseParallelGC"

WORKDIR /app

# 先复制依赖配置文件，缓存依赖层
COPY build.sbt ./
COPY project/plugins.sbt project/build.properties ./project/

# 提前拉取依赖并编译空项目，缓存依赖
RUN sbt update && sbt compile

# 复制整个项目代码
COPY . .

# 打包生成dist文件
RUN sbt dist

# 第二阶段：运行镜像
FROM openjdk:8-jre-slim

ENV APP_NAME somebackend-api
ENV APP_VERSION 1.0-SNAPSHOT

WORKDIR /app

# 从构建阶段复制打包好的文件
COPY --from=builder /app/target/universal/${APP_NAME}-${APP_VERSION}.zip ./

# 解压并设置执行权限
RUN unzip ${APP_NAME}-${APP_VERSION}.zip && \
    chmod +x ${APP_NAME}-${APP_VERSION}/bin/${APP_NAME}

EXPOSE 9000

ENTRYPOINT ["./somebackend-api-1.0-SNAPSHOT/bin/somebackend-api"]

构建命令 #

保持原有buildx命令即可：

docker buildx build --platform linux/amd64 -t image-name .

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