关键在于正确编写 systemd service 文件：使用 type=simple、user=指定用户、execstart 直接启动程序，禁用 & 和重定向，通过 journalctl 管理日志，确保程序响应 sigterm 并显式声明环境与权限。
如何编写 systemd service 文件让 C++ 服务被系统托管
关键不是改代码，而是写对 systemd 的 unit 文件。C++ 程序本身只需保持标准 Unix 守护行为（不自行 fork、不脱离终端、响应 SIGTERM），其余由 systemd 接管。
典型路径是把 service 文件放在 /etc/systemd/system/myapp.service，内容需明确声明启动方式、用户权限和生命周期管理：
[Unit] Description=My C++ Service After=network.target [Service] Type=simple User=myuser WorkingDirectory=/opt/myapp ExecStart=/opt/myapp/myserver --config /etc/myapp/config.yaml Restart=on-failure RestartSec=5 KillSignal=SIGTERM TimeoutStopSec=10 [Install] WantedBy=multi-user.target
-
Type=simple最常用：假设进程一启动就进入主循环，systemd把它当主进程；若程序自己 fork 出子进程并退出父进程（传统 daemon 模式），必须用Type=forking并配PIDFile=，但强烈建议避免 -
Restart=on-failure表示非 0 退出码或被信号终止时自动拉起；on-abort或always要慎用，可能掩盖崩溃问题 - 不要在
ExecStart中加&或用nohup—— 这会让systemd失去进程控制权，导致status查不到、stop失效
为什么日志不输出到 /var/log/myapp.log 而要用 journalctl
systemd 默认接管所有 stdout/stderr，不再走文件重定向。硬写 > /var/log/myapp.log 2>&1 在 ExecStart 里不仅多余，还会破坏日志结构化（丢失时间戳、优先级、unit 名等元信息）。
正确做法是让程序原样输出到标准流，然后用 systemd 的日志机制统一处理：
- 查看实时日志：
journalctl -u myapp.service -f - 按优先级过滤：
journalctl -u myapp.service -p err - 导出为文本（如需归档）：
journalctl -u myapp.service --since "2024-01-01" > /var/log/myapp.log - 如真要落盘到固定文件，可启用
SystemMaxUse=等journald配置，或用ForwardToSyslog=yes接入 rsyslog —— 但这是运维层决策，不应在 service 文件里硬编码路径
常见启动失败原因与调试方法
service 启动后显示 inactive (dead) 或 failed，别急着改代码，先看 systemd 是否真正“看到”了你的进程：
- 运行
systemctl status myapp.service，重点看最后一段的Process: XXXX ExecStart=...和Main PID:是否为空或异常 - 如果提示
Failed at step EXEC spawning，通常是路径错误、权限不足（比如myuser没有执行权限）或动态库找不到（LD_LIBRARY_PATH未设） - 如果
status显示running但实际无响应，用ps aux | grep myserver确认进程是否真在跑；再检查systemctl show myapp.service | grep -E "(ExecStart|Environment)"看环境变量是否符合预期 - C++ 程序中若用了
std::this_thread::sleep_for或阻塞 I/O 启动逻辑过长，可能导致systemd触发StartLimitIntervalSec限流，默认 10 秒内失败 5 次就锁死，此时需调大该值或加ExecStartPre=/bin/sleep 1缓冲
权限、路径与信号处理的隐性依赖
很多 C++ 服务卡在“能手动 run，但 systemctl start 就挂”，根源常是运行上下文差异：
-
User=指定的用户必须存在，且其 home 目录可读（尤其当程序读取~/.config或调用getpwuid时）；测试可用sudo -u myuser /opt/myapp/myserver --help模拟 - 所有配置路径（如
--config）、数据目录、socket 文件路径，必须对User=指定的用户可读写；WorkingDirectory=不仅影响相对路径，还决定chdir()的起点 - C++ 代码里必须注册
SIGTERM处理器（signal(SIGTERM, []{ exit(0); });或更健壮的sigaction），否则systemctl stop会超时后强制KILL，导致资源未释放、状态未持久化 - 若服务需要访问硬件（如 GPIO）、网络端口（
）、或 System V IPC，需在 <code>[Service]下追加CapabilityBoundingSet=或AmbientCapabilities=，普通用户默认无权绑定80端口
最易被忽略的是工作目录和当前用户环境变量的错位——systemd 启动时不加载 shell profile，$PATH 极简，LD_LIBRARY_PATH 为空，连 which curl 都可能失败。要么静态链接依赖，要么在 service 文件里用 Environment= 显式声明。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
