Go语言实现Windows文件独占锁方法

本文深入解析了在 Windows 平台上使用 Go 语言实现真正可靠的文件独占锁的完整方案——由于 Go 标准库的 `syscall.Flock` 在 Windows 上不可用，必须借助 `golang.org/x/sys/windows` 包调用 Win32 的 `LockFileEx` API，结合 `FILE_SHARE_NONE` 句柄打开模式与精确的锁参数配置，才能达成跨进程、字节级可控、支持超时与重入语义的强独占锁定；文中不仅提供了可直接用于生产环境的封装代码，更揭示了极易被忽视的关键细节（如共享模式决定锁有效性、句柄生命周期与自动释放机制、避免裸 `Syscall6` 带来的权限陷阱），帮你避开常见坑点，轻松构建高并发下安全稳定的文件协作逻辑。

在 Windows 上使用 Go 实现文件独占锁需绕过不支持 syscall.Flock 的限制，可通过调用 Win32 API 的 LockFileEx 函数完成跨进程、可重入、支持共享/独占语义的底层文件锁定。

在 Windows 上使用 Go 实现文件独占锁需绕过不支持 `syscall.Flock` 的限制，可通过调用 Win32 API 的 `LockFileEx` 函数完成跨进程、可重入、支持共享/独占语义的底层文件锁定。

Go 标准库的 syscall.Flock 在 Windows 平台上不可用（仅限 Unix-like 系统），因此无法直接复用类 Unix 的文件锁逻辑。但 Windows 提供了成熟的 Win32 文件锁定机制：LockFileEx 是推荐的现代接口，支持重叠 I/O、超时控制、共享/独占模式切换及字节范围锁，相比已废弃的 LockFile 更加灵活与健壮。

要从 Go 调用 LockFileEx，需借助 golang.org/x/sys/windows 包（官方维护的 Windows 系统调用封装），避免手动使用 syscall.Syscall6（易因参数顺序、调用约定或权限问题导致 “Access is denied” 错误，如原提问中所述）。

以下是一个生产就绪的独占锁封装示例：

package main

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

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

type FileLock struct {
    handle windows.Handle
}

// NewExclusiveLock 尝试以独占模式锁定整个文件（阻塞式）
func NewExclusiveLock(path string) (*FileLock, error) {
    f, err := os.OpenFile(path, os.O_RDWR, 0)
    if err != nil {
        return nil, err
    }

    // 必须使用 FILE_SHARE_NONE 实现真正独占（禁止其他进程读/写/删除）
    // 注意：若文件已被其他进程以非 NONE 方式打开，此处会失败
    h, err := windows.CreateFile(
        windows.StringToUTF16Ptr(path),
        windows.GENERIC_READ|windows.GENERIC_WRITE,
        0, // 不共享：关键！等价于 FILE_SHARE_NONE
        nil,
        windows.OPEN_EXISTING,
        windows.FILE_ATTRIBUTE_NORMAL,
        0,
    )
    if err != nil {
        f.Close()
        return nil, err
    }

    // 调用 LockFileEx：LOCKFILE_EXCLUSIVE_LOCK | LOCKFILE_FAIL_IMMEDIATELY（可选）
    // 此处使用阻塞式锁定（移除 FLAG 即可）
    err = windows.LockFileEx(h, windows.LOCKFILE_EXCLUSIVE_LOCK, 0,
        0xffffffff, // 高32位长度（0表示锁整个文件）
        0xffffffff, // 低32位长度
        &windows.Overlapped{}) // 同步调用，Overlapped 可为零值
    if err != nil {
        windows.CloseHandle(h)
        f.Close()
        return nil, errors.New("failed to acquire exclusive lock: " + err.Error())
    }

    return &FileLock{handle: h}, nil
}

// Unlock 释放锁并关闭句柄
func (fl *FileLock) Unlock() error {
    defer windows.CloseHandle(fl.handle)
    return windows.UnlockFileEx(fl.handle, 0, 0xffffffff, 0xffffffff, &windows.Overlapped{})
}

// 使用示例
func main() {
    lock, err := NewExclusiveLock("config.json")
    if err != nil {
        panic(err)
    }
    defer lock.Unlock()

    // 此时其他进程调用 NewExclusiveLock("config.json") 将阻塞或返回错误
    // 可安全执行读写操作...
}

⚠️ 关键注意事项：

• 句柄共享模式决定锁有效性：必须以 dwShareMode = 0（即 FILE_SHARE_NONE）打开文件，否则即使调用 LockFileEx 成功，其他进程仍可通过不同句柄访问该文件，破坏“独占”语义；
• 锁作用于句柄，非文件路径：同一进程内重复调用 NewExclusiveLock 会创建新句柄并尝试再次加锁——若未释放前锁，将失败（Windows 不允许同一线程对同一区域重复加独占锁）；
• 进程退出时自动释放：Windows 会在句柄关闭或进程终止时自动释放所有关联锁，无需显式 Unlock（但强烈建议显式调用以提升可预测性）；
• 避免 syscall.Syscall6 手动调用：它绕过了 x/sys/windows 的安全封装，易因 ABI 差异（如 uintptr vs uint32）、错误码映射或权限上下文引发 Access is denied；始终优先使用高阶封装函数。

综上，通过 golang.org/x/sys/windows 调用 LockFileEx 是 Windows 下 Go 实现可靠文件独占锁的标准实践。它兼顾安全性、兼容性与可控性，适用于配置文件保护、单实例程序协调、日志轮转同步等典型场景。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《Go语言实现Windows文件独占锁方法》文章吧，也可关注golang学习网公众号了解相关技术文章。