在Go语言Web服务开发中，HTTP响应头的设置直接影响客户端对响应内容的正确解析，还关系到服务的安全配置和跨域支持等核心功能，需要遵循规范的操作方式。
响应头设置的基础方法
Go语言标准库net/http的http.ResponseWriter接口提供了设置响应头的核心方法，最常用的是Header()方法，它返回一个http.Header类型的对象，支持多种操作方式。
直接设置单个响应头
可以通过Set方法设置单个响应头，该方法会覆盖同名的已有响应头，适合设置唯一的头信息，比如内容类型、缓存控制等。
package main
import (
"fmt"
"net/http"
)
func handler(w http.ResponseWriter, r *http.Request) {
// 设置Content-Type响应头，指定返回内容为纯文本
w.Header().Set("Content-Type", "text/plain; charset=utf-8")
// 设置自定义响应头
w.Header().Set("X-Custom-Header", "test-value")
fmt.Fprintf(w, "响应头设置示例")
}
func main() {
http.HandleFunc("/", handler)
http.ListenAndServe(":8080", nil)
}
添加多个同名响应头
如果需要添加多个同名的响应头，比如Set-Cookie，可以使用Add方法，该方法不会覆盖已有的同名头，只会在原有基础上新增。
package main
import (
"fmt"
"net/http"
)
func handler(w http.ResponseWriter, r *http.Request) {
// 添加两个Set-Cookie响应头，不会被覆盖
w.Header().Add("Set-Cookie", "session_id=abc123; Path=/")
w.Header().Add("Set-Cookie", "user_id=123; Path=/")
fmt.Fprintf(w, "多个同名响应头设置示例")
}
func main() {
http.HandleFunc("/", handler)
http.ListenAndServe(":8080", nil)
}
响应头设置的注意事项
设置顺序要求
响应头的设置必须在调用Write方法或者WriteHeader方法之前完成，一旦开始写入响应体或者调用了WriteHeader设置状态码，再修改响应头就会失效。
package main
import (
"fmt"
"net/http"
)
func wrongHandler(w http.ResponseWriter, r *http.Request) {
// 先写入响应体，再设置响应头，设置会失效
fmt.Fprintf(w, "错误示例")
w.Header().Set("Content-Type", "application/json")
}
func rightHandler(w http.ResponseWriter, r *http.Request) {
// 先设置响应头，再写入响应体，设置生效
w.Header().Set("Content-Type", "application/json")
fmt.Fprintf(w, `{"msg": "正确示例"}`)
}
func main() {
http.HandleFunc("/wrong", wrongHandler)
http.HandleFunc("/right", rightHandler)
http.ListenAndServe(":8080", nil)
}
避免头信息被覆盖
部分场景下框架或者中间件会自动设置一些响应头，比如Content-Type，如果后续使用Set方法设置同名头，会覆盖原有配置，需要确认是否需要保留原有值。
跨域响应头的正确配置
如果Web服务需要支持跨域请求，需要正确设置Access-Control-Allow-Origin等相关响应头，注意不要随意设置为*，生产环境应指定具体的允许域名。
package main
import (
"fmt"
"net/http"
)
func corsHandler(w http.ResponseWriter, r *http.Request) {
// 设置允许的跨域来源，生产环境替换为实际域名
w.Header().Set("Access-Control-Allow-Origin", "https://ipipp.com")
w.Header().Set("Access-Control-Allow-Methods", "GET, POST, OPTIONS")
w.Header().Set("Access-Control-Allow-Headers", "Content-Type, Authorization")
// 处理OPTIONS预检请求
if r.Method == "OPTIONS" {
w.WriteHeader(http.StatusNoContent)
return
}
fmt.Fprintf(w, "跨域请求响应")
}
func main() {
http.HandleFunc("/cors", corsHandler)
http.ListenAndServe(":8080", nil)
}
常见错误场景对比
以下是常见的响应头设置错误和正确实践的对比：
| 场景 | 错误做法 | 正确做法 |
|---|---|---|
| 设置状态码后修改响应头 | 先调用WriteHeader(404)，再设置Content-Type | 先设置所有需要的响应头，再调用WriteHeader或者写入响应体 |
| 添加多个同名Cookie头 | 使用Set方法重复设置Set-Cookie | 使用Add方法添加多个Set-Cookie头 |
| 本地服务跨域配置 | 生产环境仍使用Access-Control-Allow-Origin: * | 生产环境指定具体的允许域名，如https://ipipp.com |
总结
Go语言Web服务中设置HTTP响应头需要严格遵循先设置后写入的原则，根据需求选择Set或者Add方法，同时注意跨域、状态码等场景下的配置规范。开发者可以在本地使用127.0.0.1:8080或者192.168.0.1:8080地址测试响应头配置是否符合预期，避免上线后出现解析异常或者安全问题。