Spring Boot以systemd服务运行时URL属性被误判为相对路径

问题原因 #

两种启动方式的核心差异在于环境变量的继承机制：

• SSH命令行启动时，当前用户会话的环境变量（包括PATH_TO_MYPROJECT_FOLDER）会被Spring Boot进程继承，application.properties中的${PATH_TO_MYPROJECT_FOLDER}能正常替换为绝对路径/var/lib/myprojectfolder/，H2可以识别合法的绝对路径。
• systemd服务启动时，进程默认不会继承用户会话的环境变量，PATH_TO_MYPROJECT_FOLDER变量未被加载，导致application.properties中的占位符未被替换，H2看到的路径是${PATH_TO_MYPROJECT_FOLDER}MyProjectDB，被判定为隐含相对路径，触发错误。

解决方法 #

以下三种方案任选其一即可：

方案1：在systemd服务文件中直接定义环境变量 #

修改myproject.service的[Service]段，添加Environment配置：

[Service]
# 新增环境变量配置
Environment=PATH_TO_MYPROJECT_FOLDER=/var/lib/myprojectfolder/

# 原有配置保留
Type=simple
ExecStart=/var/lib/myprojectfolder/runMyProject
SuccessExitStatus=143
User=myprojectuser

修改后执行重载和重启命令：

sudo systemctl daemon-reload
sudo systemctl restart myproject

方案2：在启动脚本中显式导出环境变量 #

修改runMyProject脚本，在执行java -jar前添加环境变量导出：

#!/bin/bash
export PATH_TO_MYPROJECT_FOLDER=/var/lib/myprojectfolder/
/usr/lib/jvm/java-17-openjdk-amd64/bin/java -jar /var/lib/myprojectfolder/myproject.jar

确保脚本权限正确：

sudo chmod +x /var/lib/myprojectfolder/runMyProject
sudo systemctl restart myproject

方案3：使用systemd环境文件集中配置 #

创建环境文件/etc/systemd/system/myproject.service.d/env.conf：

[Service]
Environment=PATH_TO_MYPROJECT_FOLDER=/var/lib/myprojectfolder/

执行重载和重启：

sudo systemctl daemon-reload
sudo systemctl restart myproject

额外验证 #

重启服务后，可以通过以下命令检查环境变量是否生效：

sudo systemctl show myproject --property=Environment

输出中应包含PATH_TO_MYPROJECT_FOLDER=/var/lib/myprojectfolder/，确认变量已被加载。

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