Laravel中使用Process执行systemctl --user命令报错求助

架构老林

2026-8-18

问题：Symfony Process执行systemctl --user启动服务失败

尝试在Ubuntu服务器上用Symfony的Symfony\Component\Process\Process组件启动用户级systemd服务，代码如下：

$process = new Process(['systemctl', '--user', 'start', $serviceName]);
try {
    $process->mustRun();
} 
catch (ProcessFailedException $ex) {
    Log::alert($ex->getMessage());
}

执行后出现错误：

The command "'systemctl' '--user' 'start' 'some_service_name.service'" failed.

Exit Code: 1(General error)

Working directory: /

Output:


Error Output:

Failed to connect to bus: $DBUS_SESSION_BUS_ADDRESS and $XDG_RUNTIME_DIR not defined (consider using --machine=<user>@.host --user to connect to bus of other user)

解决方案

错误核心是运行PHP的进程（如php-fpm、nginx对应的用户）没有目标用户的会话DBUS环境变量，systemctl --user需要连接到用户的session bus才能正常工作，以下是几种解决办法：

手动注入环境变量
先通过目标用户登录服务器，执行以下命令获取环境变量值：

echo $DBUS_SESSION_BUS_ADDRESS
echo $XDG_RUNTIME_DIR

或者用UID直接构造（默认普通用户UID是1000，可通过id -u username获取），然后在创建Process时传入这些环境变量：

$process = new Process(
    ['systemctl', '--user', 'start', $serviceName],
    null,
    [
        'DBUS_SESSION_BUS_ADDRESS' => 'unix:path=/run/user/1000/bus',
        'XDG_RUNTIME_DIR' => '/run/user/1000'
    ]
);

使用machine参数直接连接用户总线
按照错误提示的方案，改用--machine参数指定目标用户，无需依赖环境变量：

// 替换username为实际的目标用户名
$process = new Process(['systemctl', '--machine=username@.host', '--user', 'start', $serviceName]);

改用系统级服务（可选）
如果不需要用户级服务，将服务文件移到/etc/systemd/system/目录下改为系统级服务，然后用root权限执行启动命令（需确保PHP运行用户有sudo权限且无需密码验证）：
```
$process = new Process(['sudo', 'systemctl', 'start', $serviceName]);
```