Linux systemd.path PathExistsGlob 匹配文件集合的配置方法

如果目标是“目录里出现任意一个符合规则的文件，就激活一个 systemd 服务”，应使用 systemd.path 的 PathExistsGlob=。它检查至少一个文件是否匹配绝对 glob；如果 path 单元启动时匹配项已经存在，关联单元也可能立即被激活。它解决的是“存在条件”，不是每一次写入都通知一次。

官方地址：https://www.freedesktop.org/software/systemd/man/latest/systemd.path.html

PathExistsGlob 解决的是文件存在条件，不是每次写入通知

PathExistsGlob= 的语义是“至少有一个路径符合通配模式”。例如 /srv/app/inbox/*.ready 匹配到 a.ready，就可以让 path 单元激活目标 service。它不要求你为每个文件创建一个 path 单元，也不会把 glob 当成正则表达式处理。

这几个选项不要混用：

用 .path 与 .service 绑定匹配条件

下面用一个“准备文件”目录做配置示例。Unit= 让触发关系不依赖默认同名推导，阅读和迁移都更直观。配置片段是原创示例，不代表已经在本机执行。

# /etc/systemd/system/inbox-ready.path
[Unit]
Description=按 ready 文件匹配触发处理服务

[Path]
# 使用绝对 glob；至少一个 .ready 文件存在即可满足条件
PathExistsGlob=/srv/app/inbox/*.ready
# 显式写出要激活的 service，避免依赖默认同名规则
Unit=inbox-ready.service

[Install]
# 让 path 单元随 paths.target 进入启用集合
WantedBy=paths.target

# /etc/systemd/system/inbox-ready.service
[Unit]
Description=处理 inbox 中的 ready 文件

[Service]
Type=oneshot
# 处理完成后应移走或删除 ready 标记，避免条件一直为真
ExecStart=/usr/local/bin/process-ready-files

这里的关键不是把命令写得复杂，而是让职责分开：.path 只声明匹配关系，.service 负责处理文件和清理标记。若处理完成后仍保留匹配项，服务退出时 path 单元可能再次检查到满足条件，形成重复激活甚至快速循环。

启用单元后按状态和日志拆分排查

保存文件后，先让 systemd 重新读取单元，再启用 path 单元。命令只展示排查路径，不把未执行的输出当作真实结果：

# 重新读取 /etc/systemd/system 下的单元文件
sudo systemctl daemon-reload
# 启用并立即启动路径单元
sudo systemctl enable --now inbox-ready.path
# 查看匹配条件是否被 systemd 接受
systemctl status inbox-ready.path
# 单独查看关联 service 的最近日志
journalctl -u inbox-ready.service -n 50 --no-pager

如果 path 单元没有激活，先检查 glob 是否为绝对路径、目录权限是否允许 systemd 观察，以及启动时是否已有符合项。如果 path 已激活但任务没有结果，再看 inbox-ready.service 的日志和退出状态，不要继续修改 PathExistsGlob= 来掩盖 service 本身的失败。

持续匹配、隐藏文件和远程文件系统的边界

有三个容易被忽略的点。第一，匹配条件是状态而不是一次性事件：服务若不清理 *.ready，每次结束后都可能再次满足条件。第二，systemd.path 的路径参数要求绝对路径，隐藏文件通常不会按普通 glob 预期参与监控。第三，path unit 依赖 inotify 语义，远程 NFS 等由其他机器改变的文件系统不适合用它承担可靠的到达通知。

生产配置还可以结合 service 的失败策略和 path 的触发频率限制，先把“文件是否匹配”“目标单元是否启动”“处理程序是否成功”分成三层观察。这样遇到重复运行时，优先移除已处理标记或调整处理边界，而不是把 PathExistsGlob 改成另一种写入监听。

常见问题

PathExistsGlob 可以写相对路径吗？

不建议也不符合该选项的参数要求。应从根目录写绝对路径，例如 /srv/app/inbox/*.ready，不要依赖当前工作目录。

为什么 path 单元一启动，service 就执行了？

如果启动时已经存在至少一个匹配项，存在条件已经成立，关联单元可能立即被激活。这是 PathExistsGlob 的设计语义，不是延迟事件丢失。

PathExistsGlob 能替代远程目录监听吗？

不能把它当成可靠的远程文件通知机制。它受到 inotify 的文件系统边界影响；跨机器写入的 NFS 场景应另行设计传输确认或由写入方主动通知。