OpenJDK应用怎么编写systemd服务文件

陌敏同学_3739

陌敏同学_3739

2026-11-04

371人浏览

原创

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

openjdk应用怎么编写systemd服务文件

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)。

  • 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 所在目录。

mac-system-control
mac-system-control

管理和控制 macOS 系统功能。包括查看系统信息、管理进程、控制音量/亮度、 网络管理、电源管理、截图、剪贴板、Finder 操作等。当用户要求查看系统状态、 控制系统设置、管理进程、截图、调节音量亮度、查看网络信息、 关机重启睡眠等 Mac 系统操作时使用。

下载
  • 提前建用户: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。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
java
java

Java是一个通用术语,用于表示Java软件及其组件,包括“Java运行时环境 (JRE)”、“Java虚拟机 (JVM)”以及“插件”。php中文网还为大家带了Java相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

2023.06.15

11877

6

java正则表达式语法
java正则表达式语法

java正则表达式语法是一种模式匹配工具,它非常有用,可以在处理文本和字符串时快速地查找、替换、验证和提取特定的模式和数据。本专题提供java正则表达式语法的相关文章、下载和专题,供大家免费下载体验。

2023.07.05

8982

9

java自学难吗
java自学难吗

Java自学并不难。Java语言相对于其他一些编程语言而言,有着较为简洁和易读的语法,本专题为大家提供java自学难吗相关的文章,大家可以免费体验。

2023.07.31

7692

8

java配置jdk环境变量
java配置jdk环境变量

Java是一种广泛使用的高级编程语言,用于开发各种类型的应用程序。为了能够在计算机上正确运行和编译Java代码,需要正确配置Java Development Kit(JDK)环境变量。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.01

1264

3

java保留两位小数
java保留两位小数

Java是一种广泛应用于编程领域的高级编程语言。在Java中,保留两位小数是指在进行数值计算或输出时,限制小数部分只有两位有效数字,并将多余的位数进行四舍五入或截取。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.02

1008

3

java基本数据类型
java基本数据类型

java基本数据类型有:1、byte;2、short;3、int;4、long;5、float;6、double;7、char;8、boolean。本专题为大家提供java基本数据类型的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

1516

5

java有什么用
java有什么用

java可以开发应用程序、移动应用、Web应用、企业级应用、嵌入式系统等方面。本专题为大家提供java有什么用的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

3109

5

java在线网站
java在线网站

Java在线网站是指提供Java编程学习、实践和交流平台的网络服务。近年来,随着Java语言在软件开发领域的广泛应用,越来越多的人对Java编程感兴趣,并希望能够通过在线网站来学习和提高自己的Java编程技能。php中文网给大家带来了相关的视频、教程以及文章,欢迎大家前来学习阅读和下载。

2023.08.03

20371

3

配置java环境变量
配置java环境变量

配置Java环境变量是为了让操作系统能够识别和使用Java的相关命令和功能。本专题为大家提供配置java环境变量相关文章,帮助大家解决问题。

2023.08.03

1355

8

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
OpenJDK项目Wiki
OpenJDK项目Wiki

共0课时 | 0人学习

OpenJDK构建指南
OpenJDK构建指南

共0课时 | 0人学习

OpenJDK官网文档
OpenJDK官网文档

共0课时 | 0人学习