Windows 不支持 syscall.Flock，但可通过调用 Win32 API 的 LockFileEx 实现可靠的文件独占锁定，本文详解跨平台兼容的 Go 实现方案，含完整代码、错误处理与关键注意事项。
windows 不支持 `syscall.flock`，但可通过调用 win32 api 的 `lockfileex` 实现可靠的文件独占锁定，本文详解跨平台兼容的 go 实现方案，含完整代码、错误处理与关键注意事项。
在 Go 中为文件加独占锁（exclusive lock）是保障多进程/多线程安全访问的关键操作。然而，标准库的 syscall.Flock 在 Windows 平台不可用（仅限 Unix-like 系统），直接调用会触发 unsupported operation 错误。此时需借助 Windows 原生 API —— LockFileEx，它支持重叠 I/O、可中断等待及真正的排他性字节范围锁，是 Windows 下最符合语义的解决方案。
以下是一个生产可用的 Go 封装示例（基于 golang.org/x/sys/windows）：
package main
import (
"errors"
"os"
"syscall"
"unsafe"
"golang.org/x/sys/windows"
)
const (
LOCKFILE_EXCLUSIVE_LOCK = 0x00000002
INFINITE = 0xFFFFFFFF
)
type FileLock struct {
f *os.File
}
func NewFileLock(f *os.File) *FileLock {
return &FileLock{f: f}
}
// Lock 对整个文件加独占锁（阻塞式）
func (fl *FileLock) Lock() error {
h := windows.Handle(fl.f.Fd())
var overlapped windows.Overlapped
// LockFileEx 返回 bool，失败时 GetLastError() 获取具体错误
ret, err := windows.LockFileEx(h, LOCKFILE_EXCLUSIVE_LOCK, 0, 0xFFFFFFFF, 0xFFFFFFFF, &overlapped)
if !ret {
return errors.New("failed to acquire exclusive file lock: " + err.Error())
}
return nil
}
// Unlock 释放锁（注意：必须使用同一句柄且未关闭文件）
func (fl *FileLock) Unlock() error {
h := windows.Handle(fl.f.Fd())
var overlapped windows.Overlapped
ret, err := windows.UnlockFileEx(h, 0, 0xFFFFFFFF, 0xFFFFFFFF, &overlapped)
if !ret {
return errors.New("failed to release file lock: " + err.Error())
}
return nil
}
// 使用示例
func main() {
f, err := os.OpenFile("example.txt", os.O_RDWR|os.O_CREATE, 0644)
if err != nil {
panic(err)
}
defer f.Close()
lock := NewFileLock(f)
if err := lock.Lock(); err != nil {
panic(err)
}
defer lock.Unlock() // 确保锁被释放
// 此处执行受保护的文件操作
_, _ = f.Write([]byte("locked write\n"))
}⚠️ 关键注意事项：
- 句柄有效性：LockFileEx 锁定的是底层文件句柄（HANDLE），若文件被 Close() 后再尝试 Unlock 将失败；务必保证 Unlock 在 f.Close() 之前调用。
- 锁粒度：示例中锁定整个文件（0xFFFFFFFF 字节长度），如需部分锁定，可传入精确的偏移量和长度。
- 进程级而非线程级：该锁作用于进程间，同一进程内重复调用 Lock 不会阻塞（Windows 允许同句柄重入），需业务层自行规避。
- 跨平台兼容建议：可结合 build tags（如 +build windows）隔离实现，并对外提供统一接口（如 Lock() / Unlock()），便于 Linux/macOS 复用 flock。
- 错误处理：常见失败原因包括权限不足（需文件具有 GENERIC_WRITE 权限）、文件已由其他进程独占锁定（ERROR_LOCK_VIOLATION）、或句柄无效。建议捕获 windows.GetLastError() 进行精细化诊断。
综上，LockFileEx 是 Windows 下实现 Go 文件独占锁的标准、可靠方式。相比轮询或临时文件等权宜方案，它具备内核级原子性、低开销与强语义保证，适用于日志写入、配置更新、数据库快照等对一致性要求严格的场景。
