使用 sync.RWMutex 实现读写分离控制，允许多个读操作并发执行，但读与写、写与写互斥，从而在不阻塞读取的前提下保证文件操作的一致性与安全性。
使用 `sync.rwmutex` 实现读写分离控制，允许多个读操作并发执行，但读与写、写与写互斥，从而在不阻塞读取的前提下保证文件操作的一致性与安全性。
在高并发 Web 服务中，常需将请求日志、指标数据或临时状态持续追加写入同一文件（如 access.log 或 metrics.dat），同时又需支持定时解析、监控告警或调试查询等读取行为。此时若直接对文件进行无协调的读写，极易遭遇竞态条件（race condition）：例如读取时文件正被截断、重写或处于中间写入状态，导致解析失败、数据错乱甚至 panic。
标准且推荐的解决方案是引入 读写互斥锁（sync.RWMutex） —— 它专为“多读少写”场景设计：
- RLock() / RUnlock()：允许多个 goroutine 同时读取，无阻塞；
- Lock() / Unlock()：写操作独占，会阻塞所有新读/写请求，直至当前写完成。
⚠️ 注意：RWMutex 保护的是对文件的访问行为，而非文件内容本身。它不能防止外部进程修改文件，也不能解决“写入未刷盘即被读取”的问题。因此，实际应用中还需配合以下最佳实践：
✅ 正确用法示例（含文件 I/O）
package main
import (
"fmt"
"io"
"os"
"sync"
)
var fileMutex = new(sync.RWMutex)
const logFile = "requests.log"
// 安全写入：追加模式 + 显式 flush（可选）
func appendLog(line string) error {
fileMutex.Lock()
defer fileMutex.Unlock()
f, err := os.OpenFile(logFile, os.O_APPEND|os.O_CREATE|os.O_WRONLY, 0644)
if err != nil {
return err
}
defer f.Close()
_, err = io.WriteString(f, line+"\n")
return err
}
// 安全读取：完整读取（适合中小文件）或流式解析（适合大文件）
func readLogFile() ([]byte, error) {
fileMutex.RLock()
defer fileMutex.RUnlock()
data, err := os.ReadFile(logFile) // Go 1.16+
if err != nil {
return nil, fmt.Errorf("failed to read log: %w", err)
}
return data, nil
}
? 关键注意事项
- 避免锁内长时间 I/O：RWMutex 是内存锁，不应在 Lock() 或 RLock() 区域内执行耗时操作（如网络请求、复杂计算）。文件打开、读写本身较快，但若需处理 GB 级日志，建议改用 bufio.Scanner 流式读取，并确保 defer fileMutex.RUnlock() 在循环外正确配对。
- 写入模式选择：优先使用 O_APPEND 模式追加写入，避免 Seek+Write 引发的覆盖风险；若需覆盖整个文件（如快照导出），应先写入临时文件，再原子重命名（os.Rename），并在此过程中持有 Lock()。
- 跨进程不适用：sync.RWMutex 仅作用于当前进程内的 goroutine。若存在多个进程同时读写同一文件（如 sidecar 容器），需改用文件系统级锁（如 flock）或外部协调服务（如 Redis 分布式锁）。
- 性能权衡：RWMutex 在读多写少时优势显著；若写入极其频繁（如每毫秒数次），可能造成读请求排队，此时可考虑环形缓冲区（ring buffer）、内存映射（mmap）或异步日志队列（如 zap 的 buffered sink）等更高级方案。
总之，sync.RWMutex 是 Go 中实现单进程内安全读写共享文件的简洁、可靠、标准模式——它不改变文件系统行为，却通过协调 goroutine 访问顺序，让“边写边读”变得可控、可预测、可维护。
