Linux下配置Python多线程服务（含多进程逻辑）为systemd服务后无法正常运行的问题求助

API 探路者

2026-5-6

排查systemd服务激活但Python脚本未正常运行的问题

我来帮你一步步排查这个问题，这类情况通常和路径、权限、日志或者多进程/线程的环境差异有关，咱们逐个分析：

1. 先查最容易忽略的：路径拼写与工作目录

看你的systemd配置里，ExecStart写的是/usr/bin/python3 /home/scrip_file_location.py——这里的scrip是不是打错了？应该是script吧？如果路径写错，Python会找不到脚本，服务看似激活但实际根本没启动。

另外，WorkingDirectory设为/home/script_location/，但脚本在/home/...py（不在这个目录下），如果你的脚本里用到了相对路径读取文件/资源，会因为工作目录不对找不到文件，导致脚本静默退出。

解决办法：

先手动执行一遍ExecStart里的命令：/usr/bin/python3 /home/scrip_file_location.py，看能不能正常运行，这能快速验证路径和脚本本身的问题。
如果脚本里有相对路径，要么把WorkingDirectory改成脚本所在的目录，要么把脚本里的路径全改成绝对路径。

systemctl status只显示简短状态，很多时候看不到核心错误，必须看journalctl的完整日志：

# 实时查看服务日志（适合启动服务时实时观察）
journalctl -u myservicename -f

# 查看最近的服务日志
journalctl -u myservicename --since "10 minutes ago"

日志里会显示Python的报错信息，比如：

举个常见例子：如果你的脚本用了虚拟环境的依赖，但systemd用的是系统Python，就会出现ImportError，这时候要么给ExecStart指定虚拟环境的Python路径（比如/home/venv/bin/python3），要么在系统Python里安装依赖。

你用的是Type=simple，这个类型要求服务的主进程一直运行，直到服务停止。你的脚本里主线程会join两个无限循环的线程，理论上主进程不会退出，但如果：

base_func()执行时出错，直接导致脚本退出
loop_func_1或loop_func_2里有未捕获的异常，导致线程退出，主线程join完成后也跟着退出，systemd会认为服务正常结束，但你觉得脚本没运行

解决办法：

在脚本里给所有可能出错的地方加上异常捕获，把错误信息打印出来（比如用try-except包裹，然后print或logging记录），这样日志里就能看到哪里出问题了。
可以把服务类型改成Type=exec（更严格的类型，确保主进程是脚本本身），不过simple大部分时候也没问题，先解决核心错误更重要。

你的loop_func_1里用到了多进程，这里有几个坑：

fork vs spawn：Linux下multiprocessing默认用fork，但如果你的线程已经启动后再fork，可能会导致资源混乱（比如线程锁、文件描述符），建议在脚本开头明确设置spawn：
```
import multiprocessing
multiprocessing.set_start_method('spawn')
```
systemd的进程限制：systemd默认会限制进程的资源，比如LimitNPROC，如果多进程创建数量超过限制，会失败。可以在[Service]段里添加：
```
LimitNPROC=infinity
```
先测试是否是这个问题，再根据实际情况调整数值。

systemd运行服务时的环境变量和你终端里的不一样，比如PATH、HOME等，而且默认用root用户运行（如果没指定User），这可能导致：

解决办法：

手动设置环境变量，比如：

Environment="PATH=/usr/local/bin:/usr/bin:/bin"

先从手动执行脚本和查看journalctl日志开始，这两个步骤几乎能解决80%的问题，找到具体报错后再针对性处理就容易多了。

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