在Windows系统中，由于syscall.Flock不被支持，需借助Win32 API的LockFileEx函数实现真正的文件独占锁；本文详解如何通过CGO调用系统API安全、可靠地完成跨进程文件锁定。
在windows系统中，由于`syscall.flock`不被支持，需借助win32 api的`lockfileex`函数实现真正的文件独占锁；本文详解如何通过cgo调用系统api安全、可靠地完成跨进程文件锁定。
在Go语言中实现Windows平台下的文件独占锁（exclusive file lock），核心在于绕过POSIX风格的flock机制，转而调用原生Win32 API——尤其是LockFileEx函数。该函数支持重叠I/O、可中断等待、字节范围锁及最重要的排他性写入锁（LOCKFILE_EXCLUSIVE_LOCK），是Windows下最标准、最健壮的文件同步原语。
✅ 推荐实现方式：使用golang.org/x/sys/windows封装调用
无需手动编写CGO代码，推荐直接使用官方维护的x/sys/windows包，它已完整封装LockFileEx和UnlockFileEx：
package main
import (
"fmt"
"os"
"syscall"
"unsafe"
"golang.org/x/sys/windows"
)
// LockFileEx flags
const (
LOCKFILE_EXCLUSIVE_LOCK = 2
LOCKFILE_FAIL_IMMEDIATELY = 1
)
// ExclusiveLock 尝试对整个文件加独占锁（阻塞直到成功或出错）
func ExclusiveLock(f *os.File) error {
h, err := windows.HandleOf(f)
if err != nil {
return fmt.Errorf("failed to get handle: %w", err)
}
// 锁定整个文件：从0开始，长度为0表示“到文件末尾”
var overlapped windows.Overlapped
err = windows.LockFileEx(h,
LOCKFILE_EXCLUSIVE_LOCK|LOCKFILE_FAIL_IMMEDIATELY,
0, // dwReserved
0, // nNumberOfBytesToLockLow (0 → lock entire file)
0, // nNumberOfBytesToLockHigh
&overlapped)
if err != nil {
return fmt.Errorf("failed to lock file: %w", err)
}
return nil
}
// UnlockFile 解锁（必须与LockFileEx配对使用）
func UnlockFile(f *os.File) error {
h, err := windows.HandleOf(f)
if err != nil {
return err
}
var overlapped windows.Overlapped
return windows.UnlockFileEx(h, 0, 0, 0, &overlapped)
}
func main() {
f, err := os.OpenFile("test.lock", os.O_CREATE|os.O_RDWR, 0644)
if err != nil {
panic(err)
}
defer f.Close()
if err := ExclusiveLock(f); err != nil {
if err == syscall.Errno(windows.ERROR_LOCK_VIOLATION) {
fmt.Println("❌ 文件已被其他进程锁定")
return
}
panic(fmt.Sprintf("lock failed: %v", err))
}
fmt.Println("✅ 文件已成功加独占锁")
// 模拟临界区操作（如写配置、更新状态等）
_, _ = f.Write([]byte("locked at " + fmt.Sprint(os.Getpid()) + "\n"))
// 记得及时解锁（或defer解锁）
if err := UnlockFile(f); err != nil {
fmt.Printf("warning: unlock failed: %v\n", err)
}
}⚠️ 关键注意事项
- 句柄有效性：LockFileEx作用于操作系统句柄（HANDLE），必须确保传入的是由os.File导出的有效句柄（通过windows.HandleOf获取），不可对*os.File做任意转换。
- 立即失败模式：建议始终启用LOCKFILE_FAIL_IMMEDIATELY标志，避免无限阻塞；业务逻辑应主动处理ERROR_LOCK_VIOLATION错误并实现重试或降级策略。
- 锁粒度与范围：示例中nNumberOfBytesToLockLow/High设为0表示锁定整个文件；若需精细控制（如仅锁某段偏移），需明确指定字节范围，并确保所有访问方约定一致。
- 进程生命周期绑定：Windows文件锁与打开该文件的句柄绑定，进程退出时自动释放锁（即使未显式调用UnlockFileEx），这是比Unix flock更可靠的行为，但也意味着不能跨进程复用同一句柄。
- 权限要求：调用进程需对目标文件具有GENERIC_WRITE或FILE_WRITE_DATA访问权限；若以只读方式打开文件（如os.O_RDONLY），LockFileEx将返回ERROR_ACCESS_DENIED。
✅ 替代方案对比
| 方案 | 是否跨进程 | 是否独占 | 是否推荐 | 说明 |
|---|---|---|---|---|
| CreateMutexW + 文件名 | ✅ | ❌（仅命名互斥体） | ⚠️ | 仅同步进程，不保护文件内容本身 |
| 临时文件+原子rename | ✅ | ✅ | ⚠️ | 适用于“存在即锁定”场景，但非真正I/O锁 |
| LockFileEx（本文方案） | ✅ | ✅ | ✅ | 原生、精确、可靠，唯一符合Windows语义的文件锁 |
? 总结：在Windows Go开发中，放弃syscall.Flock幻想，拥抱x/sys/windows.LockFileEx是实现生产级文件独占锁的唯一正解。它提供原子性、可预测性和系统级保障，配合清晰的错误处理与资源管理，即可构建高鲁棒性的并发文件操作逻辑。
