Linux flock 怎样设置拿不到锁时的退出码

如果脚本使用 flock -n 或 flock -w，拿不到锁时默认返回码是 1。想让调度器或上层脚本识别“锁冲突”这一状态，可以加 -E（长选项是 --conflict-exit-code），把冲突码设置为 0 到 255 之间的数值。需要注意，-E 只作用于非阻塞冲突或等待超时，不会改写被保护命令本身的退出码。

官方资料：https://man7.org/linux/man-pages/man1/flock.1.html

最小写法是 flock -n -E 75

-n 表示锁当前不可用时立即失败，-E 75 把这次冲突标记为 75。75 常用于表达临时资源不可用，但它只是脚本约定，并不是 flock 强制要求的固定值。只要调用方和脚本约定一致，其他未占用的 0 到 255 数值也可以使用。

#!/bin/sh
# -n 不等待；-E 75 让锁冲突与普通命令失败区分开
flock -n -E 75 /var/lock/report.lock -c 'echo "开始处理报表"'
status=$?

# 注释：这里只展示调用结果的读取方式，不把 75 当成业务命令的返回码
printf 'flock 返回码：%s\n' "$status"

图中的关系是静态说明：-n 和 -w 决定“是否等待”，-E 决定“冲突时返回什么”。如果没有 -n 或 -w，flock 默认会等待锁可用，不能仅靠 -E 把普通等待变成立即失败。

-E 只改变锁冲突时的返回值

限时等待的写法是 -w 秒数。当指定时间内仍未拿到锁时，-E 同样生效；-w 0 的语义等同于非阻塞模式。

#!/bin/sh
# 最多等待 3 秒；超时就用 75 表示锁冲突
flock -w 3 -E 75 /var/lock/report.lock -c 'echo "锁内任务"'
status=$?

# 注释：超时码由 -E 决定，成功或子命令失败则按各自状态处理
if [ "$status" -eq 75 ]; then
  echo '锁仍被占用，稍后重试'
elif [ "$status" -ne 0 ]; then
  echo "锁内命令失败，返回码=$status"
fi

不要把 -E 理解成“强制覆盖所有退出状态”。官方说明是：使用命令形式时，如果子命令确实执行，flock 会使用子命令的退出状态；只有非阻塞冲突或等待超时才使用 -E 指定的数值。

在 shell 中分开处理三种状态

实际脚本通常要区分：锁冲突、成功拿锁但业务命令失败、业务命令成功。下面的分支把冲突码固定在变量中，并把其他非零码原样传递给调用方。

#!/bin/sh
lock_file=/var/lock/report.lock
conflict_code=75

# 注释：flock 负责拿锁；锁内命令的非零状态不会被伪装成冲突码
if flock -n -E "$conflict_code" "$lock_file" -c 'echo "执行一次报表任务"'; then
  echo '任务完成'
  exit 0
else
  status=$?
  case "$status" in
    "$conflict_code")
      # 注释：调用方可据此安排退避或跳过本轮
      echo '本轮未拿到锁' >&2
      exit "$conflict_code"
      ;;
    *)
      # 注释：保留业务命令的真实失败码，便于上层定位
      echo "锁内任务失败：$status" >&2
      exit "$status"
      ;;
  esac
fi

这里的 75 只是示例约定。若业务命令本身也可能返回 75，就需要改用其他不冲突的约定值，或者在日志中同时记录“调用 flock 的结果”和业务命令的上下文。

几个容易误判的边界

• 不要把 -E 单独使用。没有 -n 或 -w 时，flock 默认等待；题目中的“拿不到锁就退出”需要先选择非阻塞或限时模式。
• 不要把 0 当作冲突码。-E 0 虽然在数值范围内，但会让锁冲突看起来像成功，除非调用方有额外上下文，否则不建议这样约定。
• 锁文件存在不代表锁被占用。flock 关注的是文件描述符上的锁状态，锁文件可以提前创建；脚本应判断 flock 的返回值，而不是只检查路径是否存在。
• 网络文件系统要单独评估。官方手册提醒，部分 NFS 或 CIFS 挂载的 flock 实现有限，可能出现始终失败的情况。

速查：该选哪种写法

因此，最直接的答案是：用 -n 或 -w 触发锁冲突分支，再用 -E 数字设置退出码；脚本捕获 $? 后，按冲突码和业务命令失败码分别处理。

相关问题

flock -w 超时后会执行锁内命令吗？

不会。只有成功拿到锁后才会执行被保护的命令；达到等待时间仍未拿到锁时，flock 使用 -E 的冲突码，未设置时默认是 1。

为什么锁内命令失败时不是 -E 设置的值？

-E针对的是锁冲突或等待超时。命令已经获得锁并启动后，flock 会把子命令的退出状态交给调用方，所以业务失败应在另一个分支处理。