go 中函数返回多个值（如 value, error）时，若 error 非 nil，其余返回值应视为未定义；通常按类型零值填充（如 ""、0、nil），但调用方不得依赖其有效性——这是 go 错误处理的核心契约。
go 中函数返回多个值（如 value, error）时，若 error 非 nil，其余返回值应视为未定义；通常按类型零值填充（如 ""、0、nil），但调用方不得依赖其有效性——这是 go 错误处理的核心契约。
在 Go 语言中，多返回值函数（尤其是 (T, error) 形式）的设计遵循明确的语义约定：error 是权威的控制信号，而非辅助信息。当函数返回非 nil 的 error 时，所有其他返回值（如 string、int、[]byte 等）在语义上属于“未定义状态”（undefined），调用方不应读取、检查或使用它们——无论它们实际被赋了什么值。
因此，你原始代码中的写法是完全正确且符合 Go 惯例的：
func GetBasicAuth(w http.ResponseWriter, r *http.Request) (string, error) {
secret, _, ok := r.BasicAuth()
if !ok {
return "", errors.New("missing or invalid Basic Auth header") // ✅ 零值 + error
}
return secret, nil
}这里 "" 并非“有意义的空字符串”，而是 string 类型的零值（zero value），仅用于满足函数签名要求。它的存在不传递业务语义，而纯粹是类型系统的需要。调用方必须先检查 err：
secret, err := GetBasicAuth(w, r)
if err != nil {
http.Error(w, "Unauthorized", http.StatusUnauthorized)
return
}
// ✅ 此时 secret 才是有效、可安全使用的
log.Printf("Authenticated user: %s", secret)⚠️ 关键注意事项：
- 绝不反向检查：不要写 if secret == "" && err != nil —— secret 在 err != nil 时无意义；
- 零值是惯例，非强制：虽然 Go 标准库几乎总是返回零值（如 "", 0, nil），但语言本身不强制；真正重要的是调用方始终以 err 为判断依据；
- 例外需显式文档化：少数函数（如 io.Reader.Read(p []byte) (n int, err error)）允许 n > 0 时仍返回 err（例如读取部分数据后遇 EOF 或 I/O 错误），但这类行为必须在文档中明确声明。自定义函数若需类似语义，也务必在注释中清晰说明。
✅ 最佳实践总结：
- 函数签名 (T, error) 意味着“成功时返回有效 T 和 nil error；失败时返回任意 T（推荐零值）和非 nil error”；
- 调用方必须先判错，再用值——这是 Go 错误处理的铁律；
- 零值不是占位符，而是类型安全的默认填充；它降低 panic 风险，但不承担业务含义；
- 若业务逻辑需在错误路径下提供上下文信息（如部分解析结果），应改用自定义错误类型（如实现 Unwrap() 或添加字段），而非依赖返回值。
遵循这一契约，你的代码将更健壮、更易维护，也更符合 Go 社区的工程共识。
