Revel 适合作为调用外部 AI 服务的轻量级网关，需用标准 http.Client 替代内置 client 并显式配置；API Key 应通过配置文件加载而非硬编码；流式响应须手动 flush 且调整超时；本地开发可用 runmode 切换 mock client。
Revel 框架本身不内置 AI 调用能力，但它的 HTTP 中间件、控制器生命周期和 JSON 响应支持，让它非常适合做 AI 接口的轻量级网关——关键不是“怎么在 Revel 里跑大模型”，而是“怎么让 Revel 成为调用外部 AI 服务的稳定胶水层”。
为什么不用 Revel 自带的 client 直接发请求？
Revel 的 client（如 revel.HttpClient）本质是封装了 net/http，可用，但容易踩坑：
- 默认不带连接池复用，高并发下会快速耗尽文件描述符（
too many open files） - 没有自动重试逻辑，AI 服务偶发超时或 503 时，控制器直接返回错误，前端看到白屏
- 无法统一注入
Authorization、X-Request-ID等调试/审计头
推荐改用标准 http.Client 实例，显式配置 Transport 和 Timeout，并在 app/init.go 中初始化为全局变量。
controllers.App 中如何安全调用 OpenAI 兼容接口？
别把 API Key 写死在控制器里，也别每次请求都读 .env。正确做法是：在 app/conf/app.conf 中声明配置项，用 Revel 的 revel.Config.String() 加载；调用时用 context.Params.Get("api_key") 或更稳妥地从 revel.BEConfig 提前注入到 controller 字段。
示例片段（非完整代码，仅关键逻辑）：
func (c App) Chat() revel.Result {
var req struct {
Messages []map[string]string `json:"messages"`
Model string `json:"model"`
}
if err := c.Params.BindJSON(&req); err != nil {
return c.RenderError("invalid JSON")
}
<pre class="brush:php;toolbar:false;">// 构造标准 OpenAI 兼容请求体
payload, _ := json.Marshal(map[string]interface{}{
"model": req.Model,
"messages": req.Messages,
"stream": false,
})
resp, err := aiClient.Post("https://api.openai.com/v1/chat/completions",
"application/json",
bytes.NewBuffer(payload))
if err != nil || resp.StatusCode != 200 {
return c.RenderError("AI service unavailable")
}
defer resp.Body.Close()
var result map[string]interface{}
json.NewDecoder(resp.Body).Decode(&result)
return c.RenderJSON(result)
}
如何避免流式响应（stream）在 Revel 中出错？
Revel 默认使用 http.ResponseWriter，但它不自动 flush 输出缓冲区。如果你直接写 text/event-stream 流，浏览器可能一直收不到首 chunk，直到连接超时或响应结束。
必须手动触发 flush：
- 设置
c.Response.Out.Header().Set("Content-Type", "text/event-stream") - 每次写完一个
data: ...\n\n后，立即调用c.Response.Out.Flush() - 注意：Revel 的
c.Render系统不适用于流式场景，得绕过它，直接操作c.Response.Out
另外，Revel 的 TimeoutFilter 默认 60 秒，而流式响应常需更长时间，务必在 app/filters.go 中为该 action 单独禁用或延长超时。
本地开发时如何 mock AI 接口而不改业务代码？
Revel 支持依赖注入（revel.Injector），但更轻量的做法是：利用 Revel 的 runmode 配置切换底层 client。
在 app/init.go 中：
if revel.RunMode == "dev" {
aiClient = &http.Client{
Transport: &mockTransport{}, // 返回预设 JSON 的 RoundTripper
}
} else {
aiClient = &http.Client{
Transport: &http.Transport{...},
Timeout: 30 * time.Second,
}
}
这样控制器完全无感，测试和上线只需改 conf/app.conf 里的 run.mode=dev，无需注释/开关代码。真正的难点不在调用，而在保持上下文一致性——比如用户 session ID 怎么透传给 AI 服务做审计，或者 prompt 中怎么安全注入用户权限字段。这些细节一旦漏掉，上线后就只能靠日志硬查。
