Go语言怎么用文件锁防止并发写入冲突-Golang-PHP中文网

linux/macos 下用 syscall.flock 加写锁需先以 os.o_rdwr 或 os.o_wronly 打开文件，再调用 syscall.flock(fd, syscall.lock_ex|syscall.lock_nb)；若用只读模式或未加 lock_nb 易报错或阻塞，且 lock_un 应在 close 前调用。

go语言怎么用文件锁防止并发写入冲突

syscall.Flock 在 Linux/macOS 上怎么加写锁

Linux/macOS 下最轻量的方案就是 syscall.Flock，但它不是自动生效的——必须先用 os.OpenFile 打开文件（且至少带 os.O_RDWR 或 os.O_WRONLY），再对返回的 *os.File 调用 Flock(int(fd.Fd()), syscall.LOCK_EX)。

常见错误包括：

用 os.O_RDONLY 打开后尝试加 LOCK_EX，会直接报 operation not supported
忘记加 syscall.LOCK_NB，导致 goroutine 永久阻塞在锁上（尤其在调试或测试时难察觉）
在 defer f.Close() 之后才调用 Flock(..., LOCK_UN)，实际锁已在 Close() 时释放，LOCK_UN 变成无效调用

推荐写法：

fd, err := os.OpenFile("log.txt", os.O_WRONLY|os.O_CREATE|os.O_APPEND, 0644)
if err != nil {
    return err
}
defer fd.Close()

if err = syscall.Flock(int(fd.Fd()), syscall.LOCK_EX|syscall.LOCK_NB); err != nil {
    return fmt.Errorf("failed to acquire lock: %w", err)
}
defer syscall.Flock(int(fd.Fd()), syscall.LOCK_UN)

_, _ = fd.WriteString("new line\n")

Windows 下为什么不能用 syscall.Flock

Windows 没有 flock 系统调用，编译时会直接报错：undefined: syscall.Flock。这不是 Go 版本问题，而是平台限制——syscall 包里对应常量和函数在 Windows 构建标签下根本没定义。

可行替代方式只有两种：

用 golang.org/x/sys/windows 调用 LockFileEx：需确保文件句柄通过 windows.CreateFile 打开（不能用 os.OpenFile），且 numberOfBytesToLockLow 至少为 1，否则返回 ERROR_INVALID_PARAMETER
用第三方库如 github.com/leekchan/goflock 或 github.com/go-flock/flock：它们内部用 //go:build windows 和 //go:build !windows 分发实现，对外统一提供 TryLock() 接口，省去条件编译胶水代码

注意：Windows 文件锁基于路径而非 inode，若进程 A 锁住 a.txt 后，进程 B 把它重命名为 b.txt，A 的锁依然有效，但新打开的 b.txt 不受该锁约束——这点和 Unix 行为不一致。

Go语言（Golang）1.26.0

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

下载

sync.Mutex 为什么不能解决多进程冲突

sync.Mutex 完全无效于跨进程场景。它只锁当前进程内的内存变量，对磁盘文件无任何控制力。两个独立运行的 Go 程序（比如两个 ./server 实例）同时写同一个文件，sync.Mutex 彼此完全不可见。

典型误用模式：

在包变量声明 var mu sync.Mutex，然后每个写操作前 mu.Lock() —— 这只能防止单个二进制内多个 goroutine 冲突
把 os.OpenFile 放在锁块里，以为“打开+写入”是原子的 —— 实际上另一个进程可能在你 OpenFile 返回后、Write 前就完成了整个写入

真正起作用的永远是内核级锁：flock、LockFileEx、或通过 os.O_APPEND + 单 goroutine channel 消费这种规避竞争的设计。