如何在macOS上将基于NanoHttp daemon的Java应用注册为系统服务？

macOS使用launchd作为系统服务管理工具，替代Windows下的Apache Commons Daemon，以下是具体实现步骤：

1. 编写Launch Daemon配置文件 #

系统级服务需创建.plist格式的配置文件，存放于/Library/LaunchDaemons/目录（用户级服务放~/Library/LaunchAgents/）。

创建名为com.yourdomain.printservice.plist的文件，示例内容如下：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <!-- 唯一服务标识，需与文件名一致 -->
    <key>Label</key>
    <string>com.yourdomain.printservice</string>
    
    <!-- 启动命令数组：指定Java路径、应用参数、Jar包路径 -->
    <key>ProgramArguments</key>
    <array>
        <string>/usr/bin/java</string>
        <string>-jar</string>
        <string>/Library/Printers/PrintService/your-print-app.jar</string>
    </array>
    
    <!-- 开机自动加载启动 -->
    <key>RunAtLoad</key>
    <true/>
    
    <!-- 应用崩溃或退出时自动重启 -->
    <key>KeepAlive</key>
    <true/>
    
    <!-- 应用工作目录 -->
    <key>WorkingDirectory</key>
    <string>/Library/Printers/PrintService</string>
    
    <!-- 标准输出日志路径 -->
    <key>StandardOutPath</key>
    <string>/var/log/printservice.log</string>
    
    <!-- 错误输出日志路径 -->
    <key>StandardErrorPath</key>
    <string>/var/log/printservice.err</string>
</dict>
</plist>

2. 部署配置文件 #

将配置文件放到指定目录，并设置正确的权限（launchd要求文件属主为root:wheel，权限644）：

# 移动文件到系统目录
sudo mv com.yourdomain.printservice.plist /Library/LaunchDaemons/

# 设置权限
sudo chown root:wheel /Library/LaunchDaemons/com.yourdomain.printservice.plist
sudo chmod 644 /Library/LaunchDaemons/com.yourdomain.printservice.plist

3. 加载并启动服务 #

使用launchctl命令完成服务的加载与启动：

# 加载服务配置
sudo launchctl load /Library/LaunchDaemons/com.yourdomain.printservice.plist

# 手动启动服务（若RunAtLoad为true，加载后会自动启动）
sudo launchctl start com.yourdomain.printservice

4. 服务日常管理命令 #

• 查看服务运行状态：

  sudo launchctl list | grep com.yourdomain.printservice
  

• 停止服务：

  sudo launchctl stop com.yourdomain.printservice
  

• 卸载服务（不再开机启动）：

  sudo launchctl unload /Library/LaunchDaemons/com.yourdomain.printservice.plist
  

关键注意事项 #

• Java路径验证：用which java确认系统默认Java路径，若需指定特定版本，使用/usr/libexec/java_home -v 17（替换为你的Java版本）获取路径。
• 绝对路径：配置文件中所有路径（Jar包、工作目录、日志）必须使用绝对路径，避免服务启动时路径错误。
• 日志权限：提前创建日志文件并设置权限，确保root用户可写入：

  sudo touch /var/log/printservice.log /var/log/printservice.err
  sudo chown root:wheel /var/log/printservice.log /var/log/printservice.err
  

• 预测试：先手动执行java -jar /path/to/your-app.jar确认应用可正常运行，再配置为服务，减少排查难度。

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