cc/PersonalWebApplication
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: 天气定位失败时不兜底、不显示

Browse Source 
线上不设 WEATHER_DEFAULT_LOCATION：高德定位失败即返回 failed，
不再回退默认城市、也不调和风，前端静默不显示。更新文档说明。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
cc 2026-06-18 20:35:54 +08:00
parent a185e56c22
commit f4342e7c82
1 changed files with 6 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

8
docs/startpage-weather-location.md
View File

@ -48,8 +48,12 @@
> 和风认证用 **JWT(EdDSA/Ed25519)**：后端用私钥签发 15 分钟有效的 token， > 和风认证用 **JWT(EdDSA/Ed25519)**：后端用私钥签发 15 分钟有效的 token，
> 以 `Authorization: Bearer` 调用。私钥**只放后端**，绝不进前端/仓库。 > 以 `Authorization: Bearer` 调用。私钥**只放后端**，绝不进前端/仓库。
> 本地开发时访问者 IP 是 `127.0.0.1`，高德无法定位 → 建议设 `WEATHER_DEFAULT_LOCATION` + > 定位失败的处理：高德对**数据中心 / DNS / 部分移动·CGNAT / 境外 IP** 会返回空。
> `WEATHER_DEFAULT_CITY` 才能在本地看到天气；部署后用访问者真实公网 IP，自动定位。 > 若**不设** `WEATHER_DEFAULT_LOCATION`，定位失败时接口直接返回 `failed` →
> **不再调和风**（省额度）→ 前端静默不显示天气。**线上有意不设兜底**，就是这个效果。
>
> 本地开发时访问者 IP 是 `127.0.0.1`，高德无法定位 → 想在本地看到天气，可临时设
> `WEATHER_DEFAULT_LOCATION` + `WEATHER_DEFAULT_CITY`（仅本地 `weather.env`，别带上线）。
## 本地运行 ## 本地运行