3f12e1da63
测试服 sys_frontend_config 3 条类型从 SECRET 改 TEXT, 小程序端现在能拿到 可直接用于地图渲染; 正式环境待运营同步改类型。 Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
59 行
2.3 KiB
Markdown
59 行
2.3 KiB
Markdown
# /mp/common/config 新增 3 个地图密钥字段
|
||
|
||
**日期**：2026-04-21
|
||
**关联 PR**：#1114（Closes #1112）
|
||
**后端服务**：无代码改动，仅配置数据变更
|
||
**环境**：测试环境已生效（正式环境待同步）
|
||
|
||
---
|
||
|
||
## 变更内容
|
||
|
||
测试服 `sys_frontend_config` 表中原本 `config_type = 'SECRET'` 的 3 条高德地图密钥配置，已统一改为 `config_type = 'TEXT'`，从而通过 `/mp/common/config` 的公开白名单过滤，**暴露给小程序端**：
|
||
|
||
| config_key | config_type 变化 | 用途 |
|
||
|------------|------------------|------|
|
||
| `AMAP_KEY` | SECRET → **TEXT** | 高德地图 API Key |
|
||
| `AMAP_SECURITY_CODE` | SECRET → **TEXT** | 高德地图安全密钥 |
|
||
| `mapApiKey` | SECRET → **TEXT** | 高德/腾讯地图 API Key |
|
||
|
||
**已执行**：
|
||
```sql
|
||
UPDATE sys_frontend_config
|
||
SET config_type = 'TEXT'
|
||
WHERE config_key IN ('mapApiKey','AMAP_KEY','AMAP_SECURITY_CODE');
|
||
```
|
||
+ `redis-cli -n 0 del mp:common:config` 清旧缓存
|
||
|
||
---
|
||
|
||
## 小程序端新增 3 个字段
|
||
|
||
`GET https://api.test.1814.love:9443/mp/common/config` 的 `data` 里现在多了：
|
||
|
||
```json
|
||
{
|
||
"AMAP_KEY": "1c0a90d053120dec577819ccf9722d2f",
|
||
"AMAP_SECURITY_CODE": "7e04d99af5bd81db393af3468ec03fee",
|
||
"mapApiKey": "874b6e2d48c9637e410da36aed3757c6"
|
||
}
|
||
```
|
||
|
||
加上之前的 15 个字段，现在 `data` 共 **18 个 key**。
|
||
|
||
---
|
||
|
||
## 前端使用建议
|
||
|
||
- 小程序端需要渲染地图（行程路线图、集合点、景点坐标等）时，直接从 `config.AMAP_KEY` / `config.mapApiKey` 读取即可，不用再硬编码在代码里
|
||
- 这些 key 受运营管理，后续密钥轮换只需在管理后台改配置 → 小程序无感（运营保存后缓存自动失效）
|
||
- 正式环境上线前运营需要在正式后台把对应 3 条配置的类型同样从「密钥」改成「文本」，或直接执行等效 SQL
|
||
|
||
---
|
||
|
||
## 注意
|
||
|
||
- `/mp/common/config` **不需要登录**即可访问（公开接口），key 会暴露在任何请求这个接口的客户端
|
||
- 如果某个 key 需要域名/AppID 限定或配额控制，需要在高德控制台绑定微信小程序 AppID、控制流量；密钥值本身本接口无法再隐藏
|
||
- 服务端专用的真正敏感配置（比如支付回调签名、数据库密码等）应继续使用 `config_type = 'SECRET'`，不会出现在本接口返回里
|