Linux服务器systemd运行React-Node应用时yarn启动报错求助

以下是导致systemd启动失败但SSH直接运行正常的几个常见原因及对应解决方法：

• 环境变量不匹配
  systemd服务默认的环境变量集合和你SSH登录用户的环境变量差异很大，比如PATH可能不包含yarn、node的用户级安装路径，或者无法读取用户目录下的yarn配置/缓存。
  解决方法：
  在[Service]段添加以下配置：

  User=developer
  Group=developer
  Environment="PATH=/home/developer/.yarn/bin:/usr/local/bin:/usr/bin"
  Environment="HOME=/home/developer"
  

  让服务以developer用户身份运行，环境变量和你SSH登录时保持一致。

• React开发服务器的非交互式运行限制
  React的start脚本（包括你自定义的startLinux）默认启动开发服务器，该服务依赖终端交互，在systemd的非后台终端环境下可能直接退出。
  解决方法：
  若为开发环境需要后台运行，修改React启动命令添加--no-open参数（create-react-app的start命令支持），并配置服务类型：
  在[Service]段添加：

  Type=simple
  Restart=always
  

  同时修改package.json里的clientLinux脚本：

  "clientLinux": "cd frontend && yarn start --no-open"
  

  若为生产环境，建议先构建React项目（yarn build），用nginx等静态文件服务器托管，而非直接运行开发服务器。

• nodemon的交互式依赖
  nodemon是开发用热重载工具，依赖终端环境输出日志、监听输入，在systemd非交互式环境下可能无法正常启动。
  解决方法：
  临时替换server脚本为直接用babel-node运行，去掉nodemon：

  "server": "babel-node src/server.js"
  

  若需要热重载，可给systemd服务配置终端支持（不推荐长期运行）：

  StandardInput=tty
  TTYPath=/dev/tty10
  

  生产环境建议直接运行编译后的代码，避免使用nodemon。

• 权限问题
  systemd默认以root运行时，可能无权限访问/home/developer/projectFolder/下的文件（如node_modules、日志），导致yarn或node执行失败。
  解决方法：
  在[Service]段指定正确的用户和组：

  User=developer
  Group=developer
  

  同时检查项目目录权限：

  chown -R developer:developer /home/developer/projectFolder/
  

• 日志排查
  若以上方法无效，查看systemd服务日志获取具体错误：

  journalctl -u webapp.service -f
  

  日志会明确指出权限不足、路径找不到或命令执行失败等问题，便于针对性解决。

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