为Java微服务编写systemd配置需定义Unit[Install]三部分:Unit设After=network.target声明依赖,Service用Type=simple、非root用户、绝对路径WorkingDirectory、完整java命令及on-failure重启策略,Install设WantedBy=multi-user.target。

OpenJDK 应用(如 Spring Boot service.jar)写 systemd 服务文件,关键不是“能不能跑”,而是“崩溃了能不能被感知、重启是否安全、日志是否可查、端口冲突会不会卡死”。直接套模板常在生产环境翻车。
ExecStart 必须用绝对路径的 java,不能写别名或省略参数
systemd 启动时没有 shell 环境,java -jar xxx.jar 会报 java: command not found。它不读 ~/.bashrc,也不继承你的 $PATH。
- 先确认真实路径:
which java,常见是/usr/bin/java或/usr/lib/jvm/java-11-openjdk-amd64/bin/java -
ExecStart要写全:比如/usr/bin/java -Xms512m -Xmx1024m -Dfile.encoding=UTF-8 -jar /opt/myapp/service.jar --server.port=8081 - 不要依赖
Environment=JAVA_HOME=...来间接调用java,除非你同时在ExecStart中显式拼出$JAVA_HOME/bin/java—— 但更易出错,不推荐 - JVM 参数建议固化:避免因环境变量缺失导致堆内存默认过小(如只给 128MB),引发 OOM 后反复
on-failure重启
Type=simple 是 Java jar 的默认且最稳妥选择
Spring Boot、Quarkus、Micrometer 等现代 Java 应用启动后主线程一直存活,进程就是服务本身。用 Type=forking 反而会让 systemd 误判主进程已退出,导致状态异常、systemctl status 显示 inactive(dead)。
管理和控制 macOS 系统功能。包括查看系统信息、管理进程、控制音量/亮度、 网络管理、电源管理、截图、剪贴板、Finder 操作等。当用户要求查看系统状态、 控制系统设置、管理进程、截图、调节音量亮度、查看网络信息、 关机重启睡眠等 Mac 系统操作时使用。
-
Type=simple(默认值):systemd 认为ExecStart启动的进程即主服务进程,生命周期直连 - 不要加
PIDFile=:jar 包没生成 PID 文件的逻辑,写了反而让 systemd 等不到文件而超时失败 - 如果用了
spring-boot-maven-plugin打成 “executable jar”,它内部虽有 fork 行为,但对外仍是 simple 模型,无需改Type
User 和 WorkingDirectory 不设,90% 的权限和路径错误就来自这里
不指定 User,服务默认以 root 运行 —— 这不仅违反最小权限原则,还会导致 ~/.m2、java.io.tmpdir、配置文件加载路径等全部错乱;不设 WorkingDirectory,Spring Boot 的 --spring.config.location=file:./config/ 会从 / 开始找,而不是你期望的 jar 所在目录。
- 提前建用户:
sudo useradd -r -s /bin/false appuser,再sudo chown -R appuser:appuser /opt/myapp -
User=appuser+Group=appuser必须成对出现,否则 group 权限可能不生效 -
WorkingDirectory=/opt/myapp必须是绝对路径,且该目录需对appuser可读可执行(chmod 755) - 如果 jar 依赖外部
application.yml,把它放/opt/myapp/config/application.yml,再通过--spring.config.location=file:./config/加载,路径才真正可控
Restart=on-failure 要配 StartLimitIntervalSec + RestartSec,否则可能雪崩
Java 应用启动失败原因很杂:端口被占、数据库连不上、Nacos 未就绪、配置 YAML 格式错误……这些本该人工介入,但若只写 Restart=always,systemd 会在几秒内反复拉起又崩溃,刷爆磁盘日志,还可能把下游依赖(如注册中心)拖垮。
-
Restart=on-failure:仅当进程非零退出、被信号终止、超时等明确失败场景才重启 -
RestartSec=5:每次重启前等 5 秒,留出依赖恢复时间 -
StartLimitIntervalSec=60+StartLimitBurst=3:1 分钟内最多启动 3 次,超限后systemctl start直接拒绝,强制你去看journalctl -u myapp.service -n 100 - 别加
RestartPreventExitStatus=:除非你真清楚哪些退出码是“正常退出”,否则容易掩盖真实问题
最容易被忽略的是:systemd 不会自动 reload 你改过的 .service 文件,systemctl daemon-reload 必须手动执行;还有,journalctl -u myapp.service 默认只保留最近几次启动的日志,要查历史得加 --all 或配置 /etc/systemd/journald.conf 中的 MaxRetentionSec。

















