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