Revel模板不能调用外部API，因其仅是纯渲染引擎，不支持HTTP客户端或任意Go代码执行；所有API请求必须在控制器中完成并传入导出字段结构体，否则模板访问失败或静默为空。
Revel 模板本身不能直接调用外部 API——它没有 HTTP 客户端能力，也不支持异步或阻塞式网络请求。所有外部数据必须在控制器中预先获取、处理并传入模板，否则模板渲染会失败或静默为空。
为什么模板里不能写 http.Get 或 json.Unmarshal
Go 的 text/template（Revel 所用）是纯渲染引擎，不执行任意 Go 代码，只调用注册的模板函数。你无法在 {{ }} 中写 http.Get("https://api.example.com")，这会触发解析错误：function "http" not defined。即使强行注册一个函数，也会破坏模板的无状态性与并发安全性——多个请求共享同一模板实例时，HTTP 调用可能互相干扰或超时卡死。
正确做法：在控制器中完成 API 调用并传参
把外部 API 请求逻辑放在控制器 action 中，用标准 net/http + encoding/json 处理，再通过 c.Render 把结果传给模板。
- 确保 API 响应结构体字段全部首字母大写（导出），否则模板无法访问：
type ApiResponse struct { Data []Item `json:"data"` } - 对空响应、超时、4xx/5xx 状态码做显式判断，避免将
nil切片或未初始化结构体传入模板（否则{{range .Data}}会 panic） - 不要在模板中尝试“兜底 fallback”，比如
{{if not .Data}}<code>fetching...{{end}} —— 这种逻辑应在控制器里统一处理
示例控制器片段：
func (c App) Dashboard() revel.Result {
resp, err := http.Get("https://api.example.com/stats")
if err != nil || resp.StatusCode != 200 {
c.RenderArgs["stats"] = []map[string]interface{}{}
c.RenderArgs["error"] = "Failed to load stats"
return c.RenderTemplate("App/Dashboard.html")
}
defer resp.Body.Close()
var data struct{ Stats []Stat `json:"stats"` }
if err := json.NewDecoder(resp.Body).Decode(&data); err != nil {
c.RenderArgs["stats"] = []map[string]interface{}{}
c.RenderArgs["error"] = "Invalid response format"
return c.RenderTemplate("App/Dashboard.html")
}
return c.Render("stats", data.Stats)
}
常见踩坑点：传了 nil 切片或未导出字段
如果 API 返回空数组，而你直接传 var stats []Stat（且未初始化），模板中 {{range .stats}} 会 panic；若结构体字段是小写开头（如 type Stat { name string }），模板访问 {{.name}} 会静默失败，输出空字符串且无报错提示。
- 始终初始化切片：
stats := make([]Stat, 0)或用append构造 - 结构体字段名必须大写：
Name string、CreatedAt time.Time - 若需传递原始 JSON 字符串供前端 JS 使用，提前转成
template.JS类型：c.RenderArgs["rawJson"] = template.JS(jsonBytes)，模板中用{{.rawJson}}（不转义）
进阶：需要多次调用不同 API？用 goroutine 并发获取
单个页面依赖多个后端服务时，别串行调用。在控制器中用 goroutine + sync.WaitGroup 或 errgroup.Group 并发拉取，再合并结果传入模板。
- 注意：并发请设超时（
context.WithTimeout），防止一个慢接口拖垮整个页面 - 避免在 goroutine 中直接操作
c.RenderArgs——需加锁或用 channel 收集结果 - 不要为省事把
http.Client放进全局变量而不设Timeout，容易引发连接泄漏
真正难的不是“怎么调”，而是“在哪调、怎么容错、怎么传”。模板只是最终呈现层，所有 IO 和错误边界必须收束在控制器里。漏掉一次 nil 检查或字段导出，就会让页面白屏且无日志可查。
