go语言需用接口+条件编译实现跨平台文件锁,因syscall.flock不支持windows;unix用flock非阻塞调用,windows用createfile+file_share_none;锁路径须绝对且标准化,unlock仅在trylock成功后调用。

Go 语言没有内置跨平台文件锁,直接用 syscall.Flock 会编译失败或运行崩溃(Windows 不支持),必须做平台抽象。最稳妥的路径是:用接口定义行为 + 条件编译实现,而不是硬塞 syscall 或依赖临时文件“伪锁”。
为什么不能直接用 syscall.Flock
syscall.Flock 在 Linux/macOS 可用,但 Windows 完全不识别该系统调用;即使加了 //go:build !windows,也会导致代码分支割裂、测试难覆盖、错误处理逻辑不一致。更麻烦的是,Flock 锁绑定到文件描述符,进程 fork 或 goroutine 间传递 fd 极易出错;且它默认是阻塞的,非阻塞需手动加 syscall.LOCK_NB,失败时返回 syscall.EWOULDBLOCK 或 syscall.EAGAIN,不同系统 errno 还不统一。
- Linux 上
syscall.Flock(fd, syscall.LOCK_EX|syscall.LOCK_NB)失败返回syscall.EWOULDBLOCK - macOS 同样返回
EWOULDBLOCK,但语义上等价于EAGAIN - Windows 根本不进这个分支,必须走
os.CreateFile+FILE_SHARE_NONE路径
推荐架构:接口 + 条件编译 + 文件句柄生命周期绑定
核心是把锁行为抽象为 Locker 接口,让具体实现只负责“打开—尝试独占—关闭”这一件事,不暴露底层句柄。每个锁实例持有自己的 *os.File,避免复用 fd 导致锁状态混乱。
- 定义统一接口:
TryLock(path string) (bool, error)和Unlock() error,明确非阻塞契约 - Unix 实现:用
os.OpenFile(path, os.O_CREATE|os.O_RDWR, 0600)打开锁文件,再调syscall.Flock(fd, syscall.LOCK_EX|syscall.LOCK_NB) - Windows 实现:用
os.CreateFile(path, ...)配合dwShareMode=0(即FILE_SHARE_NONE),打开失败即视为锁已被占用 - 所有实现中,
Unlock()必须关闭对应*os.File,否则锁不会释放(Windows 尤其严格)
flock 库 vs 自研封装:选哪个
第三方库如 github.com/go-flock/flock 或 github.com/martyb/lobsterlock 已验证过边界 case(比如进程崩溃时锁自动释放、符号链接处理、权限掩码),适合快速上线。但若项目对二进制体积敏感、或需定制锁超时/重试逻辑,自研更可控。
-
flock库默认阻塞,要非阻塞得显式传flock.WithTimeout(0),稍绕 -
lobsterlock的TryLock()方法天然非阻塞,返回bool,语义更贴近需求 - 自研时最容易漏掉的是:锁文件路径的父目录不存在时,
os.OpenFile会失败,需提前os.MkdirAll(filepath.Dir(path), 0755)
真正容易被忽略的点
锁文件路径不能是相对路径,也不能带软链接——不同进程 cwd 不同,软链接解析结果可能不一致,导致实际锁的是两个不同文件。所有锁路径必须是绝对路径,且建议用 filepath.Abs() 标准化;另外,Unlock() 必须在 defer 中调用,但要注意:如果 TryLock() 返回 false,Unlock() 不应被调用,否则 panic(nil pointer dereference)。正确模式是:
l := NewLocker("/var/run/myapp.lock")
ok, err := l.TryLock()
if !ok {
log.Println("lock failed:", err)
return
}
defer l.Unlock() // 只有获取成功才 defer
golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!











