fix(#188): 推理 API 路径规范化，消除双 /v1 前缀对 nginx rewrite 的隐式依赖 #192

2026-08-06T08:11:53Z

bot_dev1 commented

2026-08-06 08:11:53 +00:00

概述

修复 issue #188 [P1] 推理 API 路径规范化，消除双 /v1 前缀对 nginx rewrite 的隐式依赖（生产交付审计发现）。

问题

api/iaop/infer.ts 里 BASE_URL=/v1，但 fetchModels 拼 /v1/models、chatCompletion 拼 /v1/chat/completions，实际请求 /v1/v1/models。目前能通仅因 nginx 对 /v1/ 做了 rewrite 去前缀（巧合耦合）；nginx 配置一旦调整，推理全链路静默失效。另 cockpit/index.vue 裸 fetch('/v1/health') 未走 infer.ts 封装，路径口径不一致。

修复（前后端+部署一起改）

nginx（deploy/fba/nginx-fba.conf）：新增 location /v1/，proxy_pass http://127.0.0.1:30800/（带末尾 /，不去前缀直接透传），推理服务真实路径即 :30800/v1/*。
infer.ts：BASE_URL 改为空串，调用方统一写 /v1/models、/v1/chat/completions、/v1/health（fetchHealth 原误用 /health 已修正为 /v1/health）。
cockpit/index.vue：健康检查改走 infer.ts 的 fetchHealth() 封装，不再裸 fetch('/v1/health')。
ask() 延时：latencyMs 由硬编码 0 改为 performance.now() 实测耗时。
README：补充「推理通道路径约定」说明。

验收

路径口径统一：infer.ts 三接口与 cockpit 健康检查均走 infer.ts 封装
不再出现 /v1/v1 双前缀（BASE_URL='' + 显式 /v1/*）
nginx 配置不依赖 rewrite 去前缀
浏览器 Network 确认 /v1/models、/v1/chat/completions、/v1/health 均 200：本环境无 pnpm/node_modules，转 bot_qa 构建环境验证

fixes #188

## 概述修复 issue #188 [P1] 推理 API 路径规范化，消除双 `/v1` 前缀对 nginx rewrite 的隐式依赖（生产交付审计发现）。 ## 问题 `api/iaop/infer.ts` 里 `BASE_URL=/v1`，但 `fetchModels` 拼 `/v1/models`、`chatCompletion` 拼 `/v1/chat/completions`，实际请求 `/v1/v1/models`。目前能通仅因 nginx 对 `/v1/` 做了 rewrite 去前缀（巧合耦合）；nginx 配置一旦调整，推理全链路静默失效。另 `cockpit/index.vue` 裸 `fetch('/v1/health')` 未走 infer.ts 封装，路径口径不一致。 ## 修复（前后端+部署一起改） 1. **nginx**（`deploy/fba/nginx-fba.conf`）：新增 `location /v1/`，`proxy_pass http://127.0.0.1:30800/`（带末尾 `/`，不去前缀直接透传），推理服务真实路径即 :30800/v1/*。 2. **infer.ts**：`BASE_URL` 改为空串，调用方统一写 `/v1/models`、`/v1/chat/completions`、`/v1/health`（`fetchHealth` 原误用 `/health` 已修正为 `/v1/health`）。 3. **cockpit/index.vue**：健康检查改走 infer.ts 的 `fetchHealth()` 封装，不再裸 `fetch('/v1/health')`。 4. **ask() 延时**：`latencyMs` 由硬编码 `0` 改为 `performance.now()` 实测耗时。 5. **README**：补充「推理通道路径约定」说明。 ## 验收 - [x] 路径口径统一：infer.ts 三接口与 cockpit 健康检查均走 infer.ts 封装 - [x] 不再出现 `/v1/v1` 双前缀（BASE_URL='' + 显式 /v1/*） - [x] nginx 配置不依赖 rewrite 去前缀 - [ ] 浏览器 Network 确认 `/v1/models`、`/v1/chat/completions`、`/v1/health` 均 200：本环境无 pnpm/node_modules，转 bot_qa 构建环境验证 fixes #188

bot_dev1 added 1 commit 2026-08-06 08:11:53 +00:00

fix(#188 ): 推理 API 路径规范化，消除双 /v1 前缀对 nginx rewrite 的隐式依赖 5667fad3e1

问题：infer.ts BASE_URL=/v1，fetchModels/chatCompletion 再拼 /v1/* 导致
/v1/v1 双前缀，当前仅靠 nginx 对 /v1/ rewrite 去前缀巧合耦合才通。

修复（前后端+部署一起改）：
1. nginx-fba.conf：新增 location /v1/，proxy_pass http://127.0.0.1:30800/
   （带末尾 /，不去前缀直接透传），消除对 rewrite 的隐式依赖。
2. infer.ts：BASE_URL 改为空串，调用方统一写 /v1/models、
   /v1/chat/completions、/v1/health（fetchHealth 原误用 /health 已修正）。
3. cockpit/index.vue：健康检查改走 infer.ts 的 fetchHealth 封装，
   不再裸 fetch('/v1/health')，路径口径统一。
4. ask() latencyMs 由硬编码 0 改为 performance.now() 实测耗时。
5. README 补充推理通道路径约定说明。

验收：浏览器 Network 确认 /v1/models、/v1/chat/completions、
/v1/health 均 200 且无 /v1/v1 请求。（本环境无 pnpm，构建验证转 bot_qa）

bot_dev1 referenced this pull request

2026-08-06 08:12:05 +00:00

[P1] 推理 API 路径规范化：消除双 /v1 前缀对 nginx rewrite 的隐式依赖 #188

bot_dev2 referenced this pull request

2026-08-06 08:49:00 +00:00

[P1] 推理 API 路径规范化：消除双 /v1 前缀对 nginx rewrite 的隐式依赖 #188

bot_qa referenced this pull request

2026-08-06 09:22:12 +00:00

[P1] 推理 API 路径规范化：消除双 /v1 前缀对 nginx rewrite 的隐式依赖 #188

bot_dev3 referenced this pull request

2026-08-06 09:23:44 +00:00

[P1] 推理 API 路径规范化：消除双 /v1 前缀对 nginx rewrite 的隐式依赖 #188