Go Flock 怎样区分共享锁和排他锁的适用范围

如果多个 Go 进程都要访问同一个文件，真正难的不是记住 RLock 和 Lock 的名字，而是先判断这次操作会不会改变文件。读取配置、生成索引这类只观察内容的任务适合共享锁；写入、替换、清理和迁移则应该使用排他锁。

官方地址：https://pkg.go.dev/github.com/gofrs/flock

可以把选择规则记成一句话：只读且允许多个读者并行，用 RLock；会修改文件或必须阻止其他读者，用 Lock。如果拿不到锁时希望立即做降级处理，则分别使用 TryRLock 或 TryLock。

先看文件任务，而不是先看方法名

github.com/gofrs/flock 提供线程安全的文件锁接口。RLock 获取共享文件锁，Lock 获取排他文件锁；对应的 TryRLock 和 TryLock 都是非阻塞尝试。锁的对象是同一个锁文件路径，业务文件可以另行打开。

因此，读取一个已经稳定的配置快照时，多个进程可以同时持有共享锁。只要流程可能截断、覆盖、重命名、删除或改变文件内容，就不能把它当作读操作处理，应该先拿排他锁。

读多写少时，RLock 和 TryRLock 怎么选

阻塞式 RLock 适合“必须读到一致快照再继续”的流程，例如启动时读取由另一个进程定期生成的配置。它会等待排他锁释放，调用方需要把等待时间纳入超时和退出策略。

TryRLock 则把“现在拿不到就不读”变成明确分支。缓存刷新、可选诊断或后台巡检可以选择跳过这一轮，避免读任务长期排队：

package main

import (
	"fmt"
	"github.com/gofrs/flock"
)

func readSnapshot(path string) error {
	lock := flock.New(path + ".lock")
	// 非阻塞尝试共享锁，拿不到时让本轮读取直接降级。
	ok, err := lock.TryRLock()
	if err != nil {
		return fmt.Errorf("获取共享锁失败: %w", err)
	}
	if !ok {
		return fmt.Errorf("文件正在写入，本轮跳过")
	}
	defer func() {
		// 释放共享锁；锁文件本身不会因为 Unlock 自动删除。
		_ = lock.Unlock()
	}()
	// 这里读取 path 对应的稳定快照，不在共享锁期间执行写入。
	return nil
}

上面的分支把“错误”和“暂时拿不到锁”分开：前者需要记录或告警，后者可以重试、跳过或使用旧快照。若业务不能接受跳过，就用 RLock 或带上下文的 TryRLockContext。

修改文件时，Lock 和 TryLock 才是安全边界

写入流程通常不只是调用一次 Write：还可能包含读取旧内容、生成临时内容、替换文件和清理临时文件。只要其中任意一步会让其他读者看到不完整状态，就应该把完整的修改窗口放在排他锁内。

Lock 适合必须完成的迁移或单实例写入；TryLock 适合定时任务、互斥消费者和“已有实例工作时立即退出”的命令。获取成功后，要把所有可能返回的路径都交给统一的释放逻辑：

func updateFile(path string, data []byte) error {
	lock := flock.New(path + ".lock")
	// 排他锁覆盖整个更新窗口，防止读者看到中间状态。
	if err := lock.Lock(); err != nil {
		return fmt.Errorf("获取排他锁失败: %w", err)
	}
	defer func() {
		// 无论后续写入是否报错，都尝试释放文件锁。
		_ = lock.Unlock()
	}()

	// 示例只展示锁的边界；实际写入应检查临时文件、替换和清理错误。
	if err := writeAtomically(path, data); err != nil {
		return fmt.Errorf("更新文件失败: %w", err)
	}
	return nil
}

如果写入任务允许稍后再做，可以把第一行换成 TryLock，拿到 ok == false 时返回“已有执行者”的业务结果，而不是把它当成系统错误。

最容易踩坑的是共享锁升级

不要在持有 RLock 的同一流程中直接调用 Lock，把它当成可靠的“升级锁”。官方文档特别提醒：部分类 Unix 系统可能透明地把共享锁转换成排他锁。此时，如果代码仍以为自己只有共享锁，随后调用 Unlock 可能意外释放已经变成的排他锁。

更稳妥的做法是把读和写拆成两个阶段：先释放共享锁，再重新竞争排他锁，并重新读取需要判断的状态；或者一开始就按最坏情况拿排他锁。重新竞争意味着状态可能变化，所以写入前要再次检查版本、文件时间或业务条件。

最后可以按这张速查表做决定：

几个相关问题

共享锁能不能保护写操作？不能。共享锁表达的是多个读者可以共同进入，写入或删除文件需要排他锁。

Unlock 会删除锁文件吗？不会。它释放锁并关闭底层文件描述符，锁文件是否删除由应用决定。

不同系统上的共享锁行为完全一样吗？不保证。跨平台工具应把共享锁升级风险和释放路径当成显式设计约束。