本文详解 Go 语言中解析嵌套 JSON 数据（如 Flickr API 返回结构）的正确方式，重点解决 json.Unmarshal 后误用 int 类型调用 http.ResponseWriter.Write() 导致的类型错误，并提供多种安全、可读、符合 HTTP 语义的整数转字节流方案。
本文详解 go 语言中解析嵌套 json 数据（如 flickr api 返回结构）的正确方式，重点解决 `json.unmarshal` 后误用 `int` 类型调用 `http.responsewriter.write()` 导致的类型错误，并提供多种安全、可读、符合 http 语义的整数转字节流方案。
在 Go 中处理外部 JSON API（例如 Flickr）时，结构体定义与 JSON 解析逻辑需严格匹配，但更常见的错误往往发生在解析之后的数据使用阶段——尤其是将非字节类型（如 int）直接传给 http.ResponseWriter.Write() 方法。该方法签名要求 []byte，而 jsonData.Photos.Photo[i].Id 是 int 类型，Go 不会自动转换，因此编译或运行时报错：cannot use ... as type []byte。
✅ 正确解析 JSON：结构体定义与标签优化
首先，原始结构体定义存在两处关键问题：
- JSON 标签语法错误：json: "page" 应为 `json:"page"`（缺少反引号，且冒号后不能有空格）；
- Total 字段类型应为 string：Flickr API 返回 "total": "358260" 是字符串，而非整数，强制解析为 int 会导致 json.Unmarshal 失败（返回 invalid type for json.Number 或静默零值）。
修正后的结构体如下（使用导出字段 + 规范 JSON tag）：
type FlickrResponse struct {
Photos struct {
Page int `json:"page"`
Pages int `json:"pages"`
PerPage int `json:"perpage"`
Total string `json:"total"` // 注意：API 返回的是字符串
Photo []struct {
ID string `json:"id"` // Flickr ID 是字符串（如 "18929318980"），非 int
Owner string `json:"owner"`
Secret string `json:"secret"`
Server string `json:"server"` // 同样为字符串
Farm int `json:"farm"`
Title string `json:"title"`
IsPublic int `json:"ispublic"`
IsFriend int `json:"isfriend"`
IsFamily int `json:"isfamily"`
} `json:"photo"`
} `json:"photos"`
Stat string `json:"stat"`
}? 重要提示：Flickr 的 id、owner、secret、server 等字段在文档和实际响应中均为字符串类型。将其定义为 int 不仅语义错误，还会导致解析失败或截断（如 18929318980 超出 int32 范围）。务必以实际 JSON 值为准建模。
✅ 安全输出照片 ID：避免类型错误的三种推荐方式
w.Write() 只接受 []byte，因此必须将 ID（现为 string）或数值字段显式转换为字节切片。以下是生产环境中推荐的三种写法，按可读性 > 兼容性 > 性能排序：
方式 1：最直观 —— []byte(id)（推荐用于字符串 ID）
for _, photo := range jsonData.Photos.Photo {
w.Write([]byte(photo.ID)) // 直接转换字符串
w.Write([]byte("\n")) // 换行分隔，便于调试
}✅ 优点：简洁、无编码开销、语义清晰；
⚠️ 注意：确保 ID 是 string 类型（如上修正后），否则需先 strconv.Itoa()。
方式 2：通用数值转换 —— strconv.Itoa()（适用于 int 字段）
若你仍需输出 IsPublic 等整数字段：
import "strconv"
for _, photo := range jsonData.Photos.Photo {
w.Write([]byte(strconv.Itoa(photo.IsPublic)))
w.Write([]byte(", "))
w.Write([]byte(photo.Title))
w.Write([]byte("\n"))
}✅ 优点：类型安全、可读性强、无字节序顾虑；
? 提示：strconv.Itoa() 内部已做高效缓存，性能足够日常 Web 服务。
方式 3：二进制序列化（仅限特定协议场景）
仅当需向客户端发送原始二进制数据（如自定义协议、图像元数据流）时使用：
import "encoding/binary"
buf := make([]byte, 4)
for _, photo := range jsonData.Photos.Photo {
binary.LittleEndian.PutUint32(buf, uint32(photo.Farm))
w.Write(buf)
}❌ 不适用于常规 HTTP JSON 接口：浏览器/前端无法直接解析二进制整数流；
⚠️ 风险：需手动管理字节序、大小、符号，易出错且降低可维护性。
✅ 完整可运行示例（修复版）
package main
import (
"encoding/json"
"fmt"
"io/ioutil"
"log"
"net/http"
"strconv"
"github.com/gorilla/mux"
)
type FlickrResponse struct {
Photos struct {
Page int `json:"page"`
Pages int `json:"pages"`
PerPage int `json:"perpage"`
Total string `json:"total"`
Photo []struct {
ID string `json:"id"`
Title string `json:"title"`
IsPublic int `json:"ispublic"`
} `json:"photo"`
} `json:"photos"`
Stat string `json:"stat"`
}
func Index(w http.ResponseWriter, r *http.Request) {
w.Header().Set("Content-Type", "text/plain; charset=utf-8")
url := "https://api.flickr.com/services/rest/?method=flickr.photos.search&api_key=6b54d86b4e09671ef6a2a8c02b7a3537&text=cute+puppies&format=json&nojsoncallback=1"
resp, err := http.Get(url)
if err != nil {
http.Error(w, "API request failed: "+err.Error(), http.StatusInternalServerError)
return
}
defer resp.Body.Close()
body, err := ioutil.ReadAll(resp.Body)
if err != nil {
http.Error(w, "Failed to read response: "+err.Error(), http.StatusInternalServerError)
return
}
var data FlickrResponse
if err := json.Unmarshal(body, &data); err != nil {
http.Error(w, "JSON parse error: "+err.Error(), http.StatusBadRequest)
return
}
if data.Stat != "ok" {
http.Error(w, "Flickr API returned error: "+data.Stat, http.StatusInternalServerError)
return
}
// 安全输出每张照片 ID 和公开状态
for i, p := range data.Photos.Photo {
line := fmt.Sprintf("%d. ID=%s, Public=%s\n",
i+1,
p.ID,
strconv.FormatBool(p.IsPublic == 1),
)
w.Write([]byte(line))
}
}
func main() {
r := mux.NewRouter()
r.HandleFunc("/Index", Index).Methods("GET")
log.Println("Server starting on :8084...")
log.Fatal(http.ListenAndServe(":8084", r))
}? 关键总结与最佳实践
- 结构体即契约：JSON 字段类型（字符串/数字/布尔）必须与 Go 结构体字段类型严格一致，尤其注意 Flickr 的 id 是字符串；
- Write() ≠ Print()：http.ResponseWriter.Write() 是底层字节写入，永远需要 []byte，切勿传入 int、string（未显式转换）等类型；
- 优先使用 []byte(s) 或 fmt.Fprintf(w, ...)：对人类可读输出，fmt.Fprintf(w, "%s\n", s) 更安全、更灵活；
- 错误处理不可省略：HTTP 请求、IO 读取、JSON 解析三处均需检查 err 并返回恰当 HTTP 状态码；
- API Key 安全：示例中硬编码 key 仅用于教学，生产环境请使用环境变量或配置中心管理。
遵循以上原则，你不仅能解决当前报错，更能构建健壮、可维护的 Go JSON 客户端服务。
