登录
推荐 文章 Go 技术 课程 下载 专题 AI
首页 >  文章 >  linux

Linux systemd ConditionPathExistsGlob 怎样按路径条件启动服务

来源:17golang原创

时间:2026-11-19 18:53:47 310浏览 收藏

如果一个服务只应该在“待处理目录里已经出现某类文件”时启动,直接把启动命令丢给 systemd 往往不够。更稳妥的做法是把路径条件写进单元,让 systemd 在启动前先判断 glob 是否至少匹配一个文件或目录。

官方文档:https://www.freedesktop.org/software/systemd/man/latest/systemd.unit.html

用 ConditionPathExistsGlob= 表达“至少有一个路径匹配才允许进入启动流程”;匹配不到时,单元会被条件跳过,而不是把服务进程标记成普通启动失败。它只负责启动前判断,不会持续监听目录变化。

先分清 Exists 和 ExistsGlob

ConditionPathExists= 适合一个确定路径,例如 /etc/myapp/enabled。当输入文件名带有日期、批次号或随机后缀时,应该改用 ConditionPathExistsGlob=。systemd 官方手册对它的定义是:检查是否存在至少一个匹配指定 glob 模式的文件或目录。

本例假设归档服务只处理 /var/lib/myapp/inbox/ 下的 .ready 文件。条件表达的是“有没有候选输入”,不是“所有文件都已经准备好”,也不是“目录一变化就立即执行”。这一点决定了后面的依赖和触发方案。

把路径条件写进单元

可以创建一个专用的 archive.service。路径模式使用绝对路径,星号只负责匹配文件名;只要至少一个对象匹配,条件就成立。

[Unit]
# 只有待处理目录中存在至少一个 .ready 文件时才允许启动
Description=按路径条件执行归档
ConditionPathExistsGlob=/var/lib/myapp/inbox/*.ready
After=local-fs.target

[Service]
# 归档程序自行扫描目录并处理匹配输入
Type=oneshot
ExecStart=/usr/local/bin/myapp-archive --input /var/lib/myapp/inbox
# oneshot 完成后保持 inactive,不把它误认为常驻守护进程
RemainAfterExit=no

[Install]
# 需要开机参与时,再由 multi-user.target 拉起
WantedBy=multi-user.target

写完后执行重载和启动:

# 让 systemd 重新读取单元文件
sudo systemctl daemon-reload
# 手动触发一次条件判断
sudo systemctl start archive.service
# 查看条件结果和单元状态
systemctl status archive.service --no-pager
ConditionPathExistsGlob、Unit 条件、Service 单元和匹配文件之间关系的静态说明图
图1:单元关系说明图,查看路径匹配条件如何约束服务启动入口。

看懂条件不满足时的状态

当目录里没有任何 *.ready 文件时,systemd 会在启动前判定 condition 不成立,服务的 ExecStart 不会被执行。此时重点看 systemctl status 中的条件提示,而不要只盯着“进程有没有退出”。

# 查看本次启动相关的单元日志
journalctl -u archive.service -b --no-pager
# 查看单元解析后的条件配置
systemctl cat archive.service
# 条件成立后再次启动同一个单元
sudo systemctl start archive.service

如果条件不满足,常见表现是单元保持未激活或显示条件未满足;这和程序自身返回非零退出码导致的 failed 不是同一条故障链。排查时先用 ls -l /var/lib/myapp/inbox/ 确认文件名是否真的符合模式,再确认权限和挂载时序。

依赖关系和持续监听不是一回事

ConditionPathExistsGlob= 是单元启动前的门槛。它不会像文件监视器那样在目录中新建文件时自动再次启动服务。如果需要“文件出现就触发”,应单独设计 archive.path 或由队列、定时器、外部调度器触发;不要把 condition 当成事件源。

另一个容易混淆的点是 Requires=。依赖关系解决“要不要把另一个单元带上”,condition 解决“当前单元是否具备启动前提”。条件跳过不是服务进程失败,不能用它替代依赖错误处理;多个条件也应保持彼此独立,避免把一个模糊的 glob 写成隐式业务编排。

条件满足、条件跳过、Requires 依赖与 path 持续监听边界的静态说明图
图2:生命周期边界说明图,区分启动前条件判断与持续监听。

常见误区速查

现象更可能的原因处理方式
有文件却没有启动模式、目录权限或挂载时序不对先按同样的绝对路径检查目录和文件名,再看 status
新文件出现后没有自动执行把 condition 误当成监听器增加 .path、timer 或外部触发方案
依赖单元没启动混淆 Requires 与 Condition分别查看依赖关系和当前单元的 condition 结果

这套写法适合“启动前必须存在输入”的服务。如果任务是持续消费目录,建议把输入发现交给专门的监听或队列机制,再让 service 负责一次处理;这样路径判断、触发时机和失败重试各自有清晰边界。

相关问题

ConditionPathExistsGlob 能写相对路径吗?建议使用绝对路径,便于 systemd 在固定的文件系统上下文中判断。

条件不满足时要不要重启服务?通常不需要重启;应让下一次明确的启动触发重新评估条件,或改用 .path/timer 形成新的触发链。

怎样确认 glob 实际匹配到了什么?用与单元完全相同的绝对模式检查目录内容,并结合 systemctl status 查看条件提示;不要把条件判断写成服务程序内部的猜测。

声明:本文转载于:17golang原创 如有侵犯,请联系study_golang@163.com删除
相关阅读
更多>
最新阅读
更多>
课程推荐
更多>