Go 文件 Close 失败应该记录还是直接返回

Go 里“写入成功”不等于“文件生命周期全部成功”。os.File.Close() 返回的是 error，所以写文件时不能像读取文件那样把它永远塞进一个无视结果的 defer。如果目标是最终报表、上传前的归档文件或需要交付的导出物，关闭阶段失败通常应该返回；如果只是读取完文件、清理临时资源，才更可能只记录日志。

Close 错误为什么不能一概忽略

Close 的职责不只是“释放一个变量”。它会让文件对象停止可用，并把操作系统层面的关闭结果交回调用方。Go 官方 os.File.Close 文档明确保留了这个错误返回值；因此，忽略它是一个业务选择，而不是 API 规定。

判断标准可以先问一句：这个文件是不是业务结果的一部分？读取配置后关闭文件，读取阶段已经拿到内容，关闭失败通常不会改变这次读取的内容，可以记录并继续。生成对账单、缓存快照或待上传压缩包时，文件本身就是结果，Close 失败应让上层知道，避免把不完整产物当成成功交付。

写文件时怎样同时处理 Write、Flush 和 Close

最小写法可以使用命名返回值：正常路径返回 nil，而 defer 只在前面没有更早错误时补入关闭错误。这样既不会漏掉 Close，也不会用次要错误覆盖首个失败原因。

func writeReport(path string, data []byte) (err error) {
	f, err := os.Create(path)
	if err != nil {
		return fmt.Errorf("create %s: %w", path, err) // 创建失败，无法继续写入
	}
	defer func() {
		if closeErr := f.Close(); err == nil && closeErr != nil {
			err = fmt.Errorf("close %s: %w", path, closeErr) // 仅补记此前没有的错误
		}
	}()

	if _, err = f.Write(data); err != nil {
		return fmt.Errorf("write %s: %w", path, err) // 写入失败优先返回
	}
	return nil
}

如果中间用了 bufio.Writer，Write 可能只写进用户态缓冲区。此时应显式调用 Flush，并让它参与错误判定；否则只检查 Close，并不能说明缓冲内容已经成功交给文件。

func writeBuffered(path string, text string) (err error) {
	f, err := os.Create(path)
	if err != nil {
		return fmt.Errorf("create %s: %w", path, err) // 先报告创建阶段
	}
	defer func() {
		if closeErr := f.Close(); err == nil && closeErr != nil {
			err = fmt.Errorf("close %s: %w", path, closeErr) // 保留关闭阶段错误
		}
	}()

	w := bufio.NewWriter(f)
	if _, err = w.WriteString(text); err != nil {
		return fmt.Errorf("buffer %s: %w", path, err) // 缓冲写入失败
	}
	if err = w.Flush(); err != nil {
		return fmt.Errorf("flush %s: %w", path, err) // Flush 失败优先于 Close
	}
	return nil
}

记录还是返回：按产物重要性做决定

团队可以把处理策略固定成下面这张表。它不取代具体存储系统的错误语义，但能避免每个函数各写一套。

错误包装建议保留 path 和阶段词，例如 close export.csv: ...。调用方若要区分底层错误，继续使用 errors.Is 或 errors.As，不要只比较错误字符串。若写入已经失败，关闭错误通常只做日志上下文，不要为了“收集更多错误”而让它掩盖写入失败。

常见问题

读取文件时也必须返回 Close 错误吗？

不一定。读取内容已完整获得且文件只是输入资源时，通常记录即可；但如果关闭失败代表句柄泄漏或系统资源异常，应升级日志并观察后续影响。

Close 前要不要调用 Sync？

只有业务需要更强的落盘确认时才考虑 Sync。它增加成本，也不能替代对 Close 返回值的处理，具体策略应和存储介质及恢复方案一起定义。

Close 调用两次会怎样？

文件关闭后就不应继续使用，也不要把重复 Close 当成正常流程。把关闭集中到一个拥有资源生命周期的函数中，可以减少重复关闭和错误归属不清。

一句话落地：读取类文件的 Close 错误可以按资源风险记录，写入类文件的 Close 错误默认应返回；只要文件是业务产物，就不要在成功标记之前丢掉最后一个错误。