本文介绍在 Dokku 部署的 Ktor（或任意 Java）应用中，如何安全、可复现地将默认 Java 8 升级为 Java 11，核心方法是通过 system.properties 文件声明运行时版本，而非手动修改容器环境。
本文介绍在 dokku 部署的 ktor（或任意 java）应用中，如何安全、可复现地将默认 java 8 升级为 java 11，核心方法是通过 `system.properties` 文件声明运行时版本，而非手动修改容器环境。
Dokku 默认不内置 Java 版本管理逻辑，其 Java 支持依赖于构建插件（buildpack），最常用的是 Heroku 官方 Java Buildpack。该 buildpack 在构建阶段自动检测并安装指定的 JDK，因此切勿通过 dokku enter <app> 进入容器后手动安装或替换 Java——这不仅无法持久化（下次部署即丢失），还会破坏构建一致性与环境可追溯性。
✅ 正确做法：在项目根目录下创建 system.properties 文件，明确声明所需 Java 运行时版本：
# system.properties java.runtime.version=11
✅ 支持的值包括 8, 11, 17, 21 等 LTS 版本（具体以 Heroku Java Buildpack 文档 为准）。Dokku 会自动识别该文件，并在构建过程中下载匹配的 OpenJDK（由 Azul Zulu 或 Temurin 提供，取决于 buildpack 版本）。
确保该文件已提交至 Git 仓库，并重新触发部署：
立即学习“Java免费学习笔记（深入）”；
git add system.properties git commit -m "Specify Java 11 runtime for Dokku" git push dokku main # 或你的远程分支名
部署成功后，可通过以下命令验证 Java 版本是否生效：
dokku run <your-app-name> java -version
预期输出应类似：
openjdk version "11.0.22" 2024-01-16 OpenJDK Runtime Environment (build 11.0.22+7-LTS) Eclipse Temurin (build 11.0.22+7-LTS)
⚠️ 注意事项：
- system.properties 必须位于 Git 仓库根目录，且不可被 .gitignore 排除；
- 若项目同时使用自定义 Dockerfile，则 buildpack 机制将被绕过，此时需在 Dockerfile 中显式指定基础镜像（如 eclipse/temurin:11-jre-jammy）并自行管理 JDK；
- Ktor 应用本身无需代码修改，但请确保所用 Kotlin 编译器版本与 Java 11 兼容（推荐 Kotlin ≥ 1.5.30）；
- 多环境（如 staging/prod）若需不同 JDK 版本，建议通过分支或独立部署流程管理，而非动态覆盖 system.properties。
总结：Dokku 的 Java 版本切换本质是构建时决策，而非运行时配置。坚持“声明式版本控制”（即通过 system.properties 声明），可保障部署可重复、环境可审计、升级可回滚——这是云原生 Java 应用运维的最佳实践。
