Linux systemd.unit AssertPathExists 怎样区分启动断言与启动条件

如果服务必须依赖某个目录或配置文件，AssertPathExists= 和 ConditionPathExists= 都能检查路径，但它们给启动作业的信号完全不同：断言失败会让本次启动作业以错误结束，条件失败则通常只是跳过本次启动。两者都不会直接把 unit 状态改成 failed，所以排查时要同时看启动作业结果、unit 状态和日志。

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

先用三项指标判断发生了什么

systemd 会在排队的启动作业真正执行时检查条件和断言，依赖关系的排序仍然有效。不要只看服务当前是不是 active；建议把下面三项作为固定观察面：

AssertPathExists=：路径缺失就让启动作业失败

当服务没有目标目录就无法工作时，用 AssertPathExists= 表达“必须满足”的前置条件。例如归档服务要求挂载点已经准备好：

[Unit]
Description=Archive Worker
# 归档目录缺失时，让这次启动作业明确失败
AssertPathExists=/srv/archive

[Service]
# 这里只演示 unit 入口，实际命令按服务程序替换
ExecStart=/usr/local/bin/archive-worker

路径可以是文件、目录、设备节点、FIFO 或 socket；路径检查通常会跟随符号链接。这个设置适合“启动了也一定不能正确工作”的场景，例如关键挂载点、必需的配置目录或由运维明确承诺的工作区。它的价值不在于把 unit 标成失败，而在于让启动作业和日志明确暴露硬前置条件没有满足。

如果在 drop-in 中要删除原有的多个断言，先写一个空值清空列表，再补回需要保留的路径：

[Unit]
# 先清空厂商 unit 的断言列表，再加入本机实际路径
AssertPathExists=
AssertPathExists=/srv/production-archive

ConditionPathExists=：不适用当前环境时跳过启动

如果某个服务只在存在特定目录的机器上运行，缺少该目录并不一定是故障，ConditionPathExists= 更合适：

[Unit]
Description=Optional Report Exporter
# 没有报表目录时跳过本次启动，不把它当成硬故障
ConditionPathExists=/var/lib/report-export

[Service]
# 条件满足后才执行导出程序
ExecStart=/usr/local/bin/report-exporter

条件不满足时，启动作业会被跳过，服务可能继续保持 inactive。它适合可选组件、按机器角色启用的功能和“目录不存在就不需要启动”的单元。不要用条件掩盖真正的必需依赖，否则主机配置错误可能只留下一个看似安静的未启动服务。

用命令把作业结果、状态和日志分开看

先让 unit 文件重新载入，再检查表达式本身，最后观察一次启动请求的结果：

# 重新读取 unit 文件，避免继续使用旧配置
sudo systemctl daemon-reload

# 检查条件或断言表达式是否满足，不代替真实启动
systemd-analyze condition ConditionPathExists=/srv/archive

# 触发一次启动作业并观察返回结果
sudo systemctl start archive-worker.service

# 查看 unit 当前状态与最近的诊断信息
systemctl status archive-worker.service --no-pager
journalctl -u archive-worker.service -n 30 --no-pager

实际排查可以记录三列结果：启动命令是否成功、unit 是否仍为 inactive/active、日志是否出现断言错误。断言失败重点看启动作业返回值和日志；条件失败重点确认“跳过”是否就是设计意图。不要把“unit 没有进入 failed”误判为“断言没有生效”。

什么时候该选哪一个

• 路径缺失意味着服务必然无法提供功能：选择 AssertPathExists=，让启动作业明确失败并留下日志线索。
• 路径缺失只说明当前主机不需要这个功能：选择 ConditionPathExists=，接受本次启动被跳过。
• 需要让另一个 unit 的状态决定依赖关系时，不要把条件或断言当成依赖替代品；官方语义明确指出它们不适合条件化 unit 依赖。

一句话记忆：Assert 是“必须满足，否则这次启动报错”；Condition 是“满足才启动，不满足就跳过”。最终排查至少保留启动作业、unit 状态、日志三项证据。

常见问题

AssertPathExists= 失败后 unit 一定会显示 failed 吗？

不一定。断言影响的是启动作业，官方说明它不会直接导致 unit 进入 failed 状态，因此要同时看启动命令结果和日志。

ConditionPathExists= 可以用来等待目录稍后出现吗？

它只是执行启动时的条件检查，不负责等待或建立依赖。若目录由挂载或其它服务提供，应单独设计正确的依赖与顺序关系。