Windows下Go实现文件独占锁教程

在 Windows 平台上，Go 原生的 `syscall.Flock` 不可用，本文手把手教你绕过 POSIX 限制，利用 `golang.org/x/sys/windows` 调用 Win32 原生 `LockFileEx` API，实现真正可靠的跨进程文件独占锁——从正确打开文件（禁用共享、申请读写权限）、加锁/解锁到错误处理与防坑指南一应俱全，并附上生产级可直接复用的完整代码，助你轻松解决多进程并发访问同一文件时的数据竞争问题。

在 Windows 平台上，Go 标准库的 `syscall.Flock` 不可用，需通过 Windows 原生 API（如 `LockFileEx`）调用底层文件锁机制，本文详解如何使用 `golang.org/x/sys/windows` 安全、可靠地实现跨进程文件独占锁。

Windows 系统不支持 POSIX 风格的文件锁（如 flock），因此 Go 的 syscall.Flock 在 Windows 上直接返回 ENOSYS 错误。要实现真正的进程间独占文件锁（即其他进程无法同时读写该文件），必须调用 Windows 原生的文件锁定 API：LockFileEx（推荐）或 LockFile。其中 LockFileEx 支持重叠 I/O、可中断等待、共享/独占模式及字节范围锁，功能更完备且符合现代实践。

以下是一个生产就绪的 Go 实现示例，使用 golang.org/x/sys/windows 包封装 LockFileEx：

package main

import (
    "errors"
    "fmt"
    "os"
    "syscall"
    "unsafe"

    "golang.org/x/sys/windows"
)

const (
    LOCKFILE_EXCLUSIVE_LOCK = 2
    INFINITE                = 0xFFFFFFFF
)

// FileLock 封装 Windows 文件句柄与锁状态
type FileLock struct {
    handle windows.Handle
}

// NewFileLock 打开文件并获取可锁定句柄（需 GENERIC_READ | GENERIC_WRITE 权限）
func NewFileLock(path string) (*FileLock, error) {
    h, err := windows.CreateFile(
        windows.StringToUTF16Ptr(path),
        windows.GENERIC_READ|windows.GENERIC_WRITE,
        0, // 不共享 —— 关键：禁止其他进程同时打开
        nil,
        windows.OPEN_EXISTING,
        windows.FILE_ATTRIBUTE_NORMAL,
        0,
    )
    if err != nil {
        return nil, fmt.Errorf("failed to open file: %w", err)
    }
    return &FileLock{handle: h}, nil
}

// Lock 对整个文件加独占锁（阻塞式）
func (fl *FileLock) Lock() error {
    var overlapped windows.Overlapped
    // 锁定全部文件范围：0 到 0（表示从当前偏移开始，长度为 0 → 即整个文件）
    err := windows.LockFileEx(
        fl.handle,
        LOCKFILE_EXCLUSIVE_LOCK,
        0, // flags: 无额外标志
        0, // lowBytes: 锁定长度低32位（0 表示无限长）
        0, // highBytes: 锁定长度高32位
        &overlapped,
    )
    if err != nil {
        return fmt.Errorf("failed to acquire exclusive lock: %w", err)
    }
    return nil
}

// Unlock 释放锁（注意：CloseHandle 也会自动释放锁，但显式 Unlock 更清晰）
func (fl *FileLock) Unlock() error {
    err := windows.UnlockFileEx(fl.handle, 0, 0, 0, nil)
    if err != nil {
        return fmt.Errorf("failed to release lock: %w", err)
    }
    return nil
}

// Close 关闭句柄（隐式解锁，必须调用）
func (fl *FileLock) Close() error {
    return windows.CloseHandle(fl.handle)
}

// 使用示例
func main() {
    lock, err := NewFileLock(`C:\temp\shared.dat`)
    if err != nil {
        panic(err)
    }
    defer lock.Close()

    fmt.Println("Attempting to acquire exclusive lock...")
    if err := lock.Lock(); err != nil {
        panic(fmt.Sprintf("lock failed: %v", err))
    }
    defer lock.Unlock()

    fmt.Println("Lock acquired successfully. File is now exclusively locked.")
    // 此处可安全执行读写操作
    file, _ := os.OpenFile(`C:\temp\shared.dat`, os.O_RDWR, 0)
    defer file.Close()
    // ... 业务逻辑
}

✅ 关键注意事项：

• 打开模式决定锁有效性：必须以 GENERIC_READ | GENERIC_WRITE 打开文件，且 dwShareMode = 0（即不共享），否则其他进程仍可打开文件，导致锁失效；
• 锁作用域是句柄级别：同一进程内多个句柄对同一文件加锁不会冲突；但跨进程时，只要任一进程持有有效句柄并加锁，其他进程 LockFileEx 就会阻塞或失败；
• 锁随句柄关闭自动释放：即使未显式调用 UnlockFileEx，CloseHandle 也会释放锁——但显式 Unlock 更利于资源管理和调试；
• 避免死锁：LockFileEx 默认阻塞，如需超时控制，可传入 &overlapped 并配合 WaitForSingleObject，或设置 LOCKFILE_FAIL_IMMEDIATELY 标志（需自行处理 ERROR_IO_PENDING）；
• 权限要求：调用进程需对目标文件具有读写权限，且路径存在；若遇 "Access is denied"，请检查 UAC、防病毒软件拦截或文件是否被系统/其他应用占用（如记事本、资源管理器预览）。

总结：在 Windows 上实现 Go 文件独占锁，应放弃 POSIX 思维，转而拥抱 Win32 API。通过 golang.org/x/sys/windows 调用 LockFileEx，配合正确的文件打开方式和错误处理，即可构建健壮、可移植的跨进程文件同步机制。该方案已被 go-sqlite3、boltdb 等主流项目采用，具备充分的工程验证。

好了，本文到此结束，带大家了解了《Windows下Go实现文件独占锁教程》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多Golang知识！