答案：Go语言中通过定义统一JSON错误结构、封装响应函数、区分状态码及自定义错误类型来返回清晰错误信息。示例包括使用ErrorResponse结构体、respondWithError工具函数，并根据业务场景设置4xx或5xx状态码，提升前后端协作效率与用户体验。
在Go语言开发HTTP服务时，返回清晰的错误信息对前端调试和用户提示非常重要。Golang本身没有异常机制，因此需要手动处理并返回错误。以下是几种常见且实用的做法。
使用标准库返回JSON格式错误
大多数现代API都使用JSON格式传递数据，错误信息也应保持一致。你可以定义一个通用的错误响应结构：
type ErrorResponse struct {
Error string `json:"error"`
}
在接口中遇到错误时，设置状态码并写入JSON响应：
示例代码：
func handler(w http.ResponseWriter, r *http.Request) {
// 模拟某个操作失败
if err := someOperation(); err != nil {
w.Header().Set("Content-Type", "application/json")
w.WriteHeader(http.StatusBadRequest)
json.NewEncoder(w).Encode(ErrorResponse{Error: err.Error()})
return
}
// 正常响应
w.WriteHeader(http.StatusOK)
json.NewEncoder(w).Encode(map[string]string{"status": "success"})
}
统一错误响应函数
为避免重复代码，可以封装一个工具函数来处理错误返回：
立即学习“go语言免费学习笔记（深入）”；
func respondWithError(w http.ResponseWriter, code int, message string) {
w.Header().Set("Content-Type", "application/json")
w.WriteHeader(code)
json.NewEncoder(w).Encode(ErrorResponse{Error: message})
}
使用方式简洁明了：
if err != nil {
respondWithError(w, http.StatusInternalServerError, "操作失败")
return
}
区分业务错误与系统错误
实际项目中建议对错误进行分类。例如，参数校验失败属于客户端错误（4xx），数据库超时属于服务端错误（5xx）：
- 输入非法：返回 400 Bad Request
- 未授权访问：返回 401 Unauthorized
- 资源不存在：返回 404 Not Found
- 服务异常：返回 500 Internal Server Error
这样前端可以根据状态码做不同处理，比如重定向登录、提示用户检查输入等。
自定义错误类型增强可读性
对于复杂业务，可以定义带有状态码的错误类型：
type AppError struct {
Code int
Message string
}
func (e AppError) Error() string {
return e.Message
}
在中间件或处理器中判断类型并分别处理：
if appErr, ok := err.(*AppError); ok {
respondWithError(w, appErr.Code, appErr.Message)
} else {
respondWithError(w, 500, "内部错误")
}
基本上就这些。关键点是保持错误返回格式统一，状态码合理，信息清晰但不暴露敏感细节。这样前后端协作更高效，用户体验也更好。
