Go 配置文件怎么采用临时文件加重命名写入

配置热更新最怕的不是写入失败，而是旧文件已经被截断，新内容又没有写完。此时下一个进程读到的可能是空文件、半截 JSON，甚至无法启动。更稳妥的做法是：先把完整内容写到目标文件同目录的临时文件，检查写入、同步和关闭结果，再用 os.Rename 替换原文件；任何中途错误都保留旧配置。

临时文件方案解决的是“读者不会看到半成品”，不是自动解决并发写入、磁盘故障或跨文件系统移动。

先建立不破坏旧文件的写入边界

故障通常发生在直接使用 os.OpenFile 配合 O_TRUNC 的瞬间：旧内容先被清空，随后写入过程暴露在进程崩溃、磁盘空间不足或信号中断下。把临时文件放在目标文件旁边，读配置的进程仍然只会看到旧文件或完整的新文件，失败路径也更容易回收。

os.CreateTemp 会在指定目录创建唯一文件并以较严格的默认权限打开。不要把目录参数留空后再把临时文件移到配置目录；跨目录移动可能遇到不同文件系统限制，写入也失去同目录替换的语义。

临时文件写完后怎么安全替换原配置

下面的函数只接收已经编码好的配置字节。代码中的清理动作只在 Rename 尚未成功时生效，因此不会误删新配置。Sync 是对持久化要求更高时的明确选择；如果应用只关心进程内可见性，也应根据故障模型决定是否保留它。

package config

import (
	"fmt"
	"os"
	"path/filepath"
)

func writeConfig(target string, data []byte) (err error) {
	dir := filepath.Dir(target)
	f, err := os.CreateTemp(dir, ".app-config-*") // 临时文件与目标文件放在同一目录
	if err != nil {
		return fmt.Errorf("create temp config: %w", err)
	}
	tempName := f.Name()
	defer func() {
		_ = os.Remove(tempName) // Rename 成功后这里是幂等清理，失败时负责回收临时文件
	}()

	if _, err = f.Write(data); err != nil { // 先写完整字节内容，不触碰旧配置
		_ = f.Close()
		return fmt.Errorf("write temp config: %w", err)
	}
	if err = f.Sync(); err != nil { // 按需把文件内容提交到稳定存储
		_ = f.Close()
		return fmt.Errorf("sync temp config: %w", err)
	}
	if err = f.Close(); err != nil { // Windows 等平台替换前应先释放文件句柄
		return fmt.Errorf("close temp config: %w", err)
	}
	if err = os.Rename(tempName, target); err != nil { // 目标存在时替换非目录目标
		return fmt.Errorf("replace config: %w", err)
	}
	return nil
}

这里的关键判定是最后一个 Rename。它返回 nil，才代表目录项已经指向新文件；前面的 Write 成功并不等于替换成功。若目标文件权限需要固定值，可在临时文件创建后调用 Chmod，不要只依赖历史文件的权限。

并发、跨平台和失败清理要怎么处理

同一个进程里如果两个 goroutine 同时修改同一配置，两个临时文件都可能写成功，最后谁 Rename 谁覆盖，顺序取决于调度。给写入函数外层加 sync.Mutex，或者把更新请求串行化，才能定义覆盖顺序。多进程场景则需要锁文件、单写者服务或版本校验，不能把进程内互斥当成跨进程锁。

还要注意平台语义：Go 文档明确提示，非 Unix 平台即使在同一目录，Rename 也不保证是原子操作；Windows 上目标文件或临时文件仍被打开时也可能替换失败。对跨平台程序，应把“先关闭句柄”和“替换失败可重试或告警”写进运维策略，而不是宣称所有系统都有相同保证。

常见问题

为什么临时文件一定要和配置文件同目录？

同目录更容易保证重命名发生在同一文件系统，也避免把“写好文件”变成一次不可控的跨设备复制。

Close 之后还需要 Sync 吗？

如果要明确要求写入内容提交到稳定存储，应在 Close 前调用 Sync 并检查错误；它增加 I/O 成本，是否保留取决于配置丢失的代价。

Rename 失败能不能直接删除旧配置再重试？

不建议。删除旧配置会把可恢复状态变成不可恢复状态，应该保留旧文件、清理临时文件并记录错误。