树莓派上无法将Camel 3 Fat-Jar路由作为systemd服务启动

问题描述 #

为Apache Camel 3路由构建了fat-jar，部署在树莓派（Bullseye系统）的/opt/myhome目录下，使用Java 17手动启动（含sudo）完全正常：

/usr/bin/java -jar /opt/myhome/myhome-1.0-SNAPSHOT-jar-with-dependencies.jar

创建/lib/systemd/system/myhome.service配置文件：

[Unit]
Description=My home automation with apache camel 3.
After=network.target

[Service]
ExecStart=/usr/bin/java -jar /opt/myhome/myhome-1.0-SNAPSHOT-jar-with-dependencies.jar > /var/log/myhome.log 2>&1

[Install]
WantedBy=network.target

执行以下命令后：

sudo systemctl daemon-reload
sudo systemctl enable myhome.service
sudo systemctl start myhome.service

通过systemctl status myhome.service查看发现，进程启动后立即退出（状态显示成功），并输出Apache Camel Runner的帮助信息，手动启动时无此现象。

尝试给ExecStart添加参数：

/usr/bin/java -jar /opt/myhome/myhome-1.0-SNAPSHOT-jar-with-dependencies.jar -e 10 -d 60 -r de.powerstat.camel.homeautomation.HomeautomationRouteBuilder > /var/log/myhome.log 2>&1

结果依旧，未因参数问题返回错误退出码。

补充信息 #

• 帮助信息来自org.apache.camel.main.MainCommandLineSupport
• Jar包的META-INF/MANIFEST.MF内容：

Manifest-Version: 1.0
Archiver-Version: Plexus Archiver
Created-By: Apache Maven
Built-By: PowerStat
Build-Jdk: 17.0.2
Main-Class: de.powerstat.camel.homeautomation.MainApp

• 代码中实际路由类定义：

public class HomeautomationRouteBuilder extends RouteBuilder

可能原因及解决方向 #

1. systemd与bash环境变量差异 #

systemd启动的服务默认使用极简环境变量，缺少Java或Camel运行所需的环境变量（如JAVA_HOME、CLASSPATH或自定义配置变量），会导致Camel无法正确识别启动逻辑，触发命令行帮助输出。

解决方向：

• 在service文件的[Service]段添加必要的环境变量：

  Environment="JAVA_HOME=/usr/lib/jvm/java-17-openjdk-armhf"
  Environment="CLASSPATH=/opt/myhome/myhome-1.0-SNAPSHOT-jar-with-dependencies.jar"
  

• 或加载bash环境变量文件（按需使用，避免冗余）：

  EnvironmentFile=/etc/profile
  

2. 工作目录不匹配 #

手动启动时的工作目录是当前终端目录，而systemd默认工作目录为/，若Camel路由依赖相对路径的配置/资源文件，会导致加载失败，触发帮助输出。

解决方向：

• 在service文件的[Service]段指定工作目录：

  WorkingDirectory=/opt/myhome
  

3. Main类配置或逻辑问题 #

Manifest中指定的Main-Class为de.powerstat.camel.homeautomation.MainApp，但实际路由类是HomeautomationRouteBuilder，存在两种可能：

• Manifest中的主类名拼写错误，或实际入口类应为HomeautomationRouteBuilder
• MainApp类内部逻辑存在问题，在systemd环境下触发了Camel的命令行参数解析逻辑，输出帮助信息

解决方向：

• 检查MainApp类实现：确认是否正确初始化Camel上下文，是否存在无参数时调用帮助输出的逻辑
• 修正Manifest的Main-Class配置，确保指向正确的入口类

4. 日志重定向干扰 #

当前service中手动重定向日志的方式，可能导致systemd捕获输出异常，无法看到完整的错误信息，掩盖了实际问题。

解决方向：

• 去掉手动日志重定向，使用systemd自带日志管理：

  ExecStart=/usr/bin/java -jar /opt/myhome/myhome-1.0-SNAPSHOT-jar-with-dependencies.jar
  

• 通过journalctl -u myhome.service查看完整日志，定位问题

5. 文件权限问题 #

虽然手动sudo启动正常，但systemd启动时可能存在日志文件或jar目录的权限问题（如/var/log/myhome.log无写权限），导致进程异常退出。

解决方向：

• 确保日志文件权限正确：

  sudo touch /var/log/myhome.log
  sudo chown root:root /var/log/myhome.log
  

• 或在service中指定运行用户，确保该用户对jar目录和日志目录有读写权限：

  User=pi
  Group=pi
  

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