本文介绍一种轻量、可靠的方式，使用 go 将高频接收的小型 json 日志持久化为独立文件，通过系统级临时文件机制确保文件名全局唯一，避免冲突，适用于每日数百条日志的场景。
本文介绍一种轻量、可靠的方式，使用 go 将高频接收的小型 json 日志持久化为独立文件，通过系统级临时文件机制确保文件名全局唯一，避免冲突，适用于每日数百条日志的场景。
在不引入数据库的前提下，将每条 JSON 日志保存为单独文件是一种合理且实用的设计——尤其当日志体积小（约 1KB）、吞吐量适中（数百条/天）、且强调可读性、可追溯性与运维简易性时。文件系统足以胜任该负载，无需过度工程化。
关键挑战在于保证文件名唯一性：单纯依赖时间戳（如 20240520-102345.json）在高并发或纳秒级重入场景下仍可能冲突；手动维护计数器则增加状态复杂度和竞态风险。最佳实践是交由操作系统保障——Go 标准库提供的 os.CreateTemp（自 Go 1.16 起替代已弃用的 ioutil.TempFile）正是为此设计：
package main
import (
"encoding/json"
"os"
"path/filepath"
)
func saveJSONLog(storeDir, prefix string, data interface{}) (string, error) {
// 创建唯一临时文件（后缀自动追加，如 "log-abc123.json"）
f, err := os.CreateTemp(storeDir, prefix+"-*.json")
if err != nil {
return "", err
}
defer f.Close()
// 写入格式化 JSON
encoder := json.NewEncoder(f)
encoder.SetIndent("", " ")
if err := encoder.Encode(data); err != nil {
return "", err
}
// 获取最终唯一路径（CreateTemp 返回的文件已具名）
return f.Name(), nil
}
// 使用示例
func main() {
logData := map[string]interface{}{
"timestamp": "2024-05-20T10:30:45Z",
"level": "info",
"message": "User login successful",
"user_id": 12345,
}
fileName, err := saveJSONLog("./logs", "log", logData)
if err != nil {
panic(err)
}
println("Saved to:", fileName) // 输出类似：./logs/log-aBcD1e.json
}
✅ 优势说明：
-
os.CreateTemp在创建瞬间即完成原子性命名，底层调用mkstemp(3)，确保跨进程/线程绝对唯一； - 文件名含随机后缀（如
-aBcD1e.json），天然抗碰撞，无需额外时间/序列逻辑； - 支持自定义前缀与扩展名，语义清晰（如
"req-" + timestamp + "-*.json"）； - 若需归档语义（如按日期分目录），可组合
filepath.Join("logs", time.Now().Format("2006/01/02"))动态生成目录。
⚠️ 注意事项：
- 确保
storeDir已存在且进程有写权限，建议启动时用os.MkdirAll(storeDir, 0755)初始化； - 避免将
prefix设为空字符串或含路径分隔符，否则行为未定义； - 如需后续重命名（例如替换随机后缀为业务 ID），请先
f.Close()再os.Rename()，确保写入完成； - 对于长期运行服务，建议配合日志轮转（如按天压缩归档旧文件），防止目录膨胀。
综上，以 os.CreateTemp 为核心构建日志落盘流程，兼顾简洁性、可靠性与可维护性，是 Go 生态中处理轻量级结构化日志文件化的推荐范式。
