changelog: 保游网余额查询URI报错修复(配置补齐+540411清晰报错) (PR #3696)

changelogs-v2/2026-06/11_3696_保游网余额查询URI报错修复-修复接口-管理后台.md

@@ -0,0 +1,25 @@
+# 【修复·管理后台】保险:保游网余额查询「URI is not absolute」报错修复(配置补齐+错误提示改清晰)
+
+> 存放目录: changelogs-v2/2026-06/
+> 涉及服务: hl-order-service-v3(8086)
+> PR: #3696(已合并 dev-v3,**测试服已部署并 API 实测通过**) | 无关联工单(用户即时报修) | 日期: 2026-06-11
+> 影响范围: 管理后台**保险管理**(`/v3/admin/insurance/*`),另预防性补齐了合同/支付同类配置
+
+## ⚠️ 关键说明(前端必看 2 点)
+
+1. **余额查询恢复正常,前端无需改任何代码**:`GET /v3/admin/insurance/balance` 此前报「保游网余额查询失败: URI is not absolute」,根因是保险模块迁二期时测试环境配置漏迁(非代码 bug),已补齐并实测恢复;同因风险面(产品同步/投保/退保/充值/保单下载等所有走保游网的接口)一并解除。
+2. **错误文案变化(仅异常场景)**:今后若再出现接入配置缺失,返回新错误码 **540411**「保游网接入未配置(baoyou.api.base-url),请检查 Nacos 配置」,不会再出现晦涩的 "URI is not absolute";前端无需针对性处理,照常展示 message 即可。
+
+## 1. 实测结果(测试服网关)
+
+```
+GET /v3/admin/insurance/balance
+→ {"code":200,"message":"成功","data":0}        // 0 = 保游测试账户(apitest251208)真实余额
+
+GET /v3/admin/insurance/products?page=1&pageSize=5
+→ {"code":200,"message":"成功","data":{"total":10,...}}
+```
+
+## 2. 一并预防性补齐(无行为变化,仅消除同类隐患)
+
+二期 `hl-order-service-v3` 测试环境同批补齐了以下与一期同源同值的配置段,对应模块此前同样存在「一调就报 URI is not absolute」的隐患:微信支付(wechat.pay)、12301 电子合同(contract.platform)、腾讯电子签(tencent-esign)、保单 PDF 公网域名(oss.domain)、保险出单主体(insurance.entities)。前端如之前在二期页面遇到过合同/支付类「URI is not absolute」报错,可以重试。