usda 农贸市场 api 实际返回标准 json（非 jsonp），问题根源在于结构体定义与 api 响应格式不匹配；需根据真实响应结构调整 go 结构体，并规范错误处理与资源释放。
usda 农贸市场 api 实际返回标准 json（非 jsonp），问题根源在于结构体定义与 api 响应格式不匹配；需根据真实响应结构调整 go 结构体，并规范错误处理与资源释放。
USDA Farmers Market Directory API（如 zipSearch 端点）返回的是标准 JSON，而非 JSONP。其 HTTP 响应头明确声明 Content-Type: application/json; charset=utf-8，因此无需任何 JSONP 解析器或额外第三方包——直接使用 Go 标准库 encoding/json 即可。所谓“JSONP 无法解析”的困惑，本质是 Go 结构体字段未与实际 JSON 数据结构对齐，导致 json.Unmarshal 静默失败（字段值为空）或报错。
✅ 正确建模 API 响应结构
以 zipSearch?zip=20902 为例，真实响应为如下格式（精简）：
{
"results": [
{
"id": "1001745",
"marketname": "Bethesda Central Farm Market",
"address": "Bethesda, MD 20814",
"schedule": "Saturdays, 9:00 AM - 1:00 PM",
"products": "Baked Goods, Cheese, Crafts, Flowers, Eggs, Seafood, Herbs, Vegetables, Honey, Jams, Maple, Meat, Organic, Plants, Poultry, Prepared Food, Soap, Wine",
"googlelink": "https://www.google.com/maps/search/?api=1&query=Bethesda+Central+Farm+Market"
}
]
}对应地，Go 结构体应严格匹配嵌套层级与字段名（注意大小写和 json tag）：
type MarketResponse struct {
Results []Market `json:"results"`
}
type Market struct {
ID string `json:"id"`
MarketName string `json:"marketname"` // 注意：API 字段为小写开头的 marketname
Address string `json:"address"`
Schedule string `json:"schedule"`
Products string `json:"products"`
GoogleLink string `json:"googlelink"` // 而非 GoogleLink（驼峰命名不匹配）
}⚠️ 关键细节：
- marketname、googlelink 等字段在 API 中均为全小写，必须通过 json:"marketname" 显式映射；
- 原始代码中 MapsLink、Address 等字段名虽语义合理，但因未正确绑定 json tag 或字段名不一致，导致反序列化失败；
- 响应是对象包裹数组（{"results":[...]}），而非扁平对象，因此顶层结构体必须包含 Results []Market 字段。
✅ 完整、健壮的请求与解析示例
package main
import (
"encoding/json"
"fmt"
"io"
"log"
"net/http"
"time"
)
type MarketResponse struct {
Results []Market `json:"results"`
}
type Market struct {
ID string `json:"id"`
MarketName string `json:"marketname"`
Address string `json:"address"`
Schedule string `json:"schedule"`
Products string `json:"products"`
GoogleLink string `json:"googlelink"`
}
func fetchMarketsByZip(zipcode string) ([]Market, error) {
url := fmt.Sprintf("http://search.ams.usda.gov/farmersmarkets/v1/data.svc/zipSearch?zip=%s", zipcode)
client := &http.Client{Timeout: 10 * time.Second}
resp, err := client.Get(url)
if err != nil {
return nil, fmt.Errorf("HTTP request failed: %w", err)
}
defer func() {
if closeErr := resp.Body.Close(); closeErr != nil {
log.Printf("Failed to close response body: %v", closeErr)
}
}()
if resp.StatusCode != http.StatusOK {
return nil, fmt.Errorf("API returned status %d", resp.StatusCode)
}
body, err := io.ReadAll(resp.Body)
if err != nil {
return nil, fmt.Errorf("failed to read response body: %w", err)
}
var mr MarketResponse
if err := json.Unmarshal(body, &mr); err != nil {
return nil, fmt.Errorf("JSON unmarshal failed: %w (raw: %s)", err, string(body))
}
return mr.Results, nil
}
func main() {
markets, err := fetchMarketsByZip("20902")
if err != nil {
log.Fatal(err)
}
for i, m := range markets {
fmt.Printf("[%d] %s — %s\n", i+1, m.MarketName, m.Address)
}
}? 验证与调试建议
- 始终检查 resp.StatusCode：API 可能返回 404（无效邮编）或 500，仅检查 err 不够；
- 打印原始响应体（调试时）：log.Printf("Raw response: %s", string(body))，快速确认数据格式；
- 使用 JSON-to-Go 工具：粘贴真实 API 响应，自动生成准确结构体；
- 避免静默失败：不要仅 log.Println(err) 后继续执行；应返回错误或 panic（开发期），确保控制流明确。
✅ 总结
- USDA API 返回 标准 JSON，无需 JSONP 处理；
- 核心问题是 结构体未真实反映 API 的 JSON Schema，务必依据实际响应设计嵌套结构与 json tag；
- 强化错误处理（区分网络错误、HTTP 状态错误、JSON 解析错误）与资源管理（defer resp.Body.Close()），是生产级代码的必备实践。
