Go语言怎么使用flock实现多进程安全写文件-Golang-PHP中文网

linux/macos上用unix.flock加写锁必须用os.o_rdwr打开文件，因flock(2)要求fd支持读操作；windows不支持syscall.flock，需用lockfileex或跨平台库如gofrs/flock。

go语言怎么使用flock实现多进程安全写文件

Linux/macOS 上用 `unix.Flock` 加写锁必须带 `os.O_RDWR`

直接用 os.OpenFile(path, os.O_WRONLY, 0644) 打开再调 unix.Flock，在部分系统（尤其是 macOS）会失败，错误可能是 EBADF 或静默失效。根本原因是 flock(2) 要求文件描述符支持读操作——哪怕你只写，内核也需能读取文件元信息。

正确做法是统一用 os.O_RDWR | os.O_CREATE 打开文件：

file, err := os.OpenFile("data.json", os.O_RDWR|os.O_CREATE, 0644)
if err != nil {
    return err
}
defer file.Close()

if err := unix.Flock(int(file.Fd()), unix.LOCK_EX|unix.LOCK_NB); err != nil {
    if err == unix.EWOULDBLOCK {
        return fmt.Errorf("file locked by another process")
    }
    return err
}
// ✅ 此时可安全写入

unix.LOCK_NB 是关键：避免阻塞，失败立即返回，便于上层做重试或降级
锁绑定在 file.Fd() 上，不是路径；同一进程反复 OpenFile 会拿到不同 fd，各自加锁互不影响
锁在 file.Close() 时自动释放，defer 是最稳妥的释放方式

Windows 下不能用 `syscall.Flock`，得换方案

在 Windows 上直接 import "syscall" 并调 syscall.Flock 会编译报错：undefined: syscall.Flock。这不是 bug，是平台限制——Windows 没有 flock(2) 系统调用。

硬要自己封装 LockFileEx 容易踩坑：

必须用 windows.CreateFile 打开句柄，os.OpenFile 返回的句柄权限不够
LockFileEx 要求指定锁区域，传 0 偏移/长度会返回 ERROR_INVALID_PARAMETER
锁不会随句柄关闭自动释放，必须显式调 windows.UnlockFileEx

更现实的选择是引入 github.com/gofrs/flock。它内部做了平台判断：Unix 系统走 unix.Flock，Windows 走 LockFileEx，接口统一：

Go语言（Golang）1.26.0

Go语言（Golang）1.26.0版本官方下载，版本号 1.26.0，适合旧项目维护、兼容性测试和指定版本开发环境搭建。

下载

lock := flock.New("config.yaml")
locked, err := lock.TryLock()
if err != nil {
    log.Fatal(err)
}
if !locked {
    log.Fatal("failed to acquire lock")
}
defer lock.Unlock()