Golang 实现基于文件锁的进程间互斥逻辑-Golang-PHP中文网

不能靠os.openfile+o_excl实现可靠进程互斥，因其在nfs等环境不保证原子性、无超时机制、无法识别持有者且崩溃后锁文件残留导致假死锁；必须用flock等系统级锁或跨平台封装库。

golang 实现基于文件锁的进程间互斥逻辑

不能靠 os.OpenFile + O_EXCL 实现可靠进程互斥，必须用系统级文件锁（flock）或跨平台封装库。

为什么 `os.OpenFile` + `O_EXCL` 不行

看似简单：创建一个 lock 文件，靠原子性防止重复创建。但实际会立刻踩坑：

NFS 或某些云存储挂载点不保证 O_EXCL 原子性，多个进程可能同时创建成功
进程崩溃后 lock 文件残留，没人清理 → “假死锁”，后续所有进程都进不来
没超时机制，一旦锁被长期持有（比如卡在 IO），整个流程就卡死
无法知道谁持有了锁，调试、抢占式释放、监控全落空

`syscall.Flock` 在 Linux/macOS 上怎么安全非阻塞加锁

Go 标准库没封装 flock，得手动调用 syscall.Flock。它不是“锁文件”，而是“锁 fd”，行为和系统调用一一对应：

必须用 os.O_CREATE | os.O_RDWR 打开文件，只读打开（os.O_RDONLY）在部分内核下拿不到写锁
非阻塞加锁必须显式带上 syscall.LOCK_NB，否则默认阻塞，goroutine 直接挂起
锁绑定的是 fd，不是路径：同一文件用两次 os.OpenFile，得到两个独立 fd，互不干扰
进程退出时内核自动释放锁，但显式调用 syscall.Flock(fd, syscall.LOCK_UN) 更利于调试和资源可追溯

示例片段：

Golang Lint

Golang 项目 lint 最佳实践与 golangci‑lint 配置——运行 linter、编辑 .golangci.yml、使用 nolint指令抑制警告。

下载

file, err := os.OpenFile("app.lock", os.O_CREATE|os.O_RDWR, 0644)
if err != nil {
    log.Fatal(err)
}
defer file.Close()

err = syscall.Flock(int(file.Fd()), syscall.LOCK_EX|syscall.LOCK_NB)
if err != nil {
    if err == syscall.EWOULDBLOCK {
        log.Println("锁已被占用")
        return
    }
    log.Fatal(err)
}

Windows 下没法用 `flock`，怎么办

syscall.Flock 在 Windows 上直接 panic，因为 Win32 没这个系统调用。你有三个选择：

用 x/sys/windows 调用 LockFileEx，但要自己处理重试、超时、句柄生命周期
用成熟跨平台库，比如 github.com/nightlyone/lockfile 或 go.uber.org/atomic 的配套锁工具（注意后者不是文件锁）
如果只是防多实例启动，Windows 可用命名互斥体（CreateMutex），但和文件锁语义不一致，跨平台逻辑要拆开

别自己封装“判断文件存在 → 创建 → rename”这种伪原子操作，它在 NFS 和容器环境里基本不可靠。