journalctl 怎么按服务某次 invocation 筛选日志

同一个 systemd 服务启动、停止、重启多次后，journalctl -u 会把这些运行周期的日志放在同一结果里。想只看某一次启动，最直接的办法是先用 --list-invocations 找到目标周期，再用 --invocation 按相对次数或精确 ID 筛选；如果只想看最近一次，使用 -I 即可。

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

systemd v257 及以上可以直接使用 invocation 选项。较旧版本没有这些选项时，仍可根据 journal 中的 _SYSTEMD_INVOCATION_ID 可信字段筛选。

先给结论：三条命令覆盖大多数排障场景

下面假设服务名为 payment-worker.service。第一条列出该服务在 journal 中可见的运行周期，第二条查看最近一次，第三条查看上一次。

# 列出服务可见的 invocation 编号、ID 以及首尾日志时间
sudo journalctl -u payment-worker.service --list-invocations

# -I 等价于 --invocation=0，表示最近一次运行周期
sudo journalctl -u payment-worker.service -I -o short-iso-precise

# -1 表示最近一次之前的那个运行周期
sudo journalctl -u payment-worker.service --invocation=-1 -o short-iso-precise

--list-invocations 与 --invocation 是 systemd v257 加入的能力。先检查本机帮助中是否存在这些参数，能避免在旧发行版上把“不认识选项”误判成日志问题。

# 只检查命令是否支持 invocation 相关选项，不读取服务日志
journalctl --help | grep -E -- '--invocation|--list-invocations'

invocation 为什么能隔离同一服务的不同启动周期

invocation 不是 PID，也不是一次 systemctl restart 命令的文本记录。systemd 每当 unit 从 inactive 进入 activating 或 active 状态时，会为这个运行周期分配一个随机的 128 位 ID，并以 32 个十六进制字符表示。同一运行周期内由该 unit 启动的进程会共享 $INVOCATION_ID。

日志进入 journal 后，进程所属运行周期通常体现在可信字段 _SYSTEMD_INVOCATION_ID 中。因此，即使服务名相同，只要它经历了停止再启动，不同周期也能按 invocation 分开。PID 可能复用，时间窗口也可能跨过相邻重启，invocation ID 更适合作为一次运行的边界。

先列出 invocation，再锁定目标那一次

排查“昨晚重启后第一次启动失败”这类问题时，不要一上来就猜 -1。先列出最近几次 invocation，观察每条记录的首尾时间，再根据故障发生时刻选择相对编号或完整 ID。

# 只列出最近 10 次 invocation，便于按首尾时间定位故障周期
sudo journalctl -u payment-worker.service --list-invocations -n 10

# 新结果在前，适合先观察最近几次运行周期
sudo journalctl -u payment-worker.service --list-invocations -n 10 -r

相对编号的含义容易看反：0 是最新一次，-1 是上一次，-2 是上上次；正数则从 journal 中可见的最早 invocation 开始计算，1 代表第一条。日志轮转或清理后，“最早可见”不等于服务历史上的第一次。

按 ID、相对次数和 boot 范围组合筛选

已经拿到完整的 32 字符 ID 时，精确 ID 比相对编号更适合写进故障记录，因为后续服务再次重启不会改变这个 ID 指向的运行周期。

# 用实际的 32 字符十六进制 invocation ID 替换示例值
INVOCATION_ID='0123456789abcdef0123456789abcdef'

# 同时限定 unit 与精确 invocation，减少无关记录
sudo journalctl -u payment-worker.service \
  --invocation="$INVOCATION_ID" \
  -o short-iso-precise

# 只在上一次开机的 journal 中寻找该服务的最新 invocation
sudo journalctl -u payment-worker.service \
  -b -1 \
  --invocation=0 \
  -o short-iso-precise

-b 的价值在于缩小 invocation 的查找范围。例如服务器本次开机后服务已经重启十次，但你要查的是上次开机最后一次运行，就应把 -b -1 与 --invocation=0 组合使用。官方实现中的 --invocation 会同时匹配多个 invocation 相关字段，因此它通常比手写单一字段条件更完整。

旧版 systemd：直接按 journal 字段筛选

如果 journalctl --help 没有 invocation 选项，可以先在一个较窄的时间窗口中用 verbose 输出查看字段。找到目标记录的 _SYSTEMD_INVOCATION_ID 后，再把它作为精确匹配条件。

# 先用故障时间窗口缩小范围，verbose 输出会显示 journal 字段
sudo journalctl -u payment-worker.service \
  --since '2026-10-04 01:50:00' \
  --until '2026-10-04 02:10:00' \
  -o verbose

# 复制目标记录中的可信字段值，再筛选该运行周期的进程日志
INVOCATION_ID='0123456789abcdef0123456789abcdef'
sudo journalctl -u payment-worker.service \
  _SYSTEMD_INVOCATION_ID="$INVOCATION_ID" \
  -o short-iso-precise

也可以用 -F 枚举当前条件下出现过的字段值，但它只适合收集候选 ID，不提供可靠的时间顺序。要确认某个 ID 对应哪次故障，仍应结合 verbose 记录的时间戳判断。

# 枚举该 unit 日志中出现过的 invocation 字段值
sudo journalctl -u payment-worker.service -F _SYSTEMD_INVOCATION_ID

这个兼容写法主要覆盖服务进程产生、带有 _SYSTEMD_INVOCATION_ID 的记录。systemd 管理器自身关于 unit 的消息还可能使用 INVOCATION_ID 等字段；因此，在支持 v257 新选项的系统上，优先使用 --invocation，它会统一处理这些相关字段。

为什么会得到空结果

对于用户服务，使用 --user-unit 指定名称。命令结构与系统服务一致，只是作用域不同。

# 列出当前用户服务的运行周期
journalctl --user-unit=sync-agent.service --list-invocations

# 查看该用户服务最近一次 invocation 的日志
journalctl --user-unit=sync-agent.service --invocation=0 -o short-iso-precise

相关问题

invocation 和 boot ID 有什么区别？

boot ID 标识一次系统启动，invocation ID 标识一个 unit 的一次运行周期。同一次开机内，服务可以有多个 invocation。

为什么不用 --since 和 --until 就够了？

时间范围适合粗筛，但在频繁重启、相邻周期时间接近或日志异步写入时容易混入边界记录。invocation 是 unit 运行周期自身的标识，边界更明确。

服务 reload 会生成新的 invocation 吗？

关键判断是 unit 是否从 inactive 再进入 activating 或 active。单纯 reload 通常仍处于同一运行周期；停止后重新启动才会分配新的 invocation ID。

应该把相对编号还是完整 ID 写进故障单？

现场快速查看可以用 0、-1；需要交接或长期留档时，应保存完整 ID、unit 名称、boot 范围和故障时间，因为相对编号会随着后续重启改变参照位置。

总结

按某次服务运行筛选日志的核心不是 PID，也不是模糊时间窗口，而是 invocation ID。systemd v257 及以上先用 --list-invocations 识别目标周期，再用 --invocation=ID、--invocation=-1 或 -I 查看；跨开机记录时叠加 -b。旧版本则从 verbose 日志中取得 _SYSTEMD_INVOCATION_ID 并按字段匹配。