<p>最近没更新，在做一个名片小程序，左上角有一个天气预报模块，用的是天聚数行的天气 API，支持按城市名或传入 IP 实现自动城市定位。部署上线后出现一个奇怪的问题：<strong>不管谁访问页面，天气永远显示 CDN 边缘节点的城市，而不是访问者的真实所在地。</strong>接下来就给大家讲讲，用到的朋友们来学习一下吧</p>

<h3>背景</h3>

<p>项目栈：Nginx 反向代理 + Spring Boot 后端 + 腾讯云 EdgeOne CDN</p>

<p>天气 API 逻辑：后端获取客户端真实 IP → 作为 <code>city</code> 参数传给天聚数行 <code>tianqi</code> 接口 → 天聚数行内部 GeoIP 定位城市 → 返回天气数据</p>

<h3>排查过程</h3>

<h4>第一层：后端 IP 获取逻辑</h4>

<p>典型的 Java 获取客户端 IP 写法：</p>

<pre><code class="language-java">String ip = req.getHeader("X-Real-IP");
  if (ip == null) ip = req.getHeader("X-Forwarded-For").split(",")[0];
  if (ip == null) ip = req.getRemoteAddr();
</code></pre>
<p>在没有 CDN 时，Nginx 通过 <code>proxy_set_header X-Real-IP $remote_addr</code> 将直连客户端 IP 写入 header，后端正确获取。</p>

<p>接入 EdgeOne CDN 后，<code>$remote_addr</code> 变成了 CDN 回源节点的 IP。<strong>后端拿到的永远是边缘加速机房的 IP，不是真实客户端 IP。</strong></p>

<h4>第二层：Nginx real_ip 模块</h4>

<p>Nginx 编译了 <code>ngx_http_realip_module</code>，尝试从 <code>X-Forwarded-For</code> 中提取真实 IP：</p>

<pre><code class="language-nginx">set_real_ip_from 0.0.0.0/0;
real_ip_header X-Forwarded-For;
</code></pre>

<p>配置后天气依然不准。在后端接口加日志打印所有 IP header 后确认：<code>X-Forwarded-For</code> 的第一个 IP 仍然是 EdgeOne 节点 IP。<strong>CDN 根本没有在回源请求中注入真实客户端 IP。</strong></p>

<h4>第三层：确认根因</h4>

<p>在 <code>/api/weather</code> 接口打印所有 IP 相关 header：</p>

<table><tr><th>Header</th><th>值</th></tr><tr></tr><tr><td><code>remoteAddr</code></td><td>CDN 节点 IP</td></tr><tr><td><code>X-Forwarded-For</code></td><td>CDN 节点 IP, ...</td></tr><tr><td><code>X-Real-IP</code></td><td>CDN 节点 IP</td></tr><tr><td><code>True-Client-IP</code></td><td>null</td></tr></table>

<p>结论：<strong>EdgeOne CDN 未开启「真实客户端 IP 回源」功能。</strong> 源站看到的所有 IP 都是边缘节点的。</p>

<h3>解决方案</h3>

<h4>方案一：EdgeOne 控制台开启真实 IP 回源（推荐）</h4>

<p>登录 EdgeOne 控制台 → 站点加速 → 回源配置 → 开启「真实客户端 IP 回源」</p>

<p>开启后 EdgeOne 会将真实客户端 IP 写入 <code>X-Forwarded-For</code> 的首位。后端只需调整优先级，优先取 <code>X-Forwarded-For</code>：</p>

<pre><code class="language-java">// EdgeOne 开启真实 IP 回源后，X-Forwarded-For 第一位就是客户端 IP
<p>String ip = req.getHeader("X-Forwarded-For");</p>
<p>if (ip != null && ip.contains(",")) ip = ip.split(",")[0].trim();</p>
<p>if (ip == null || isPrivateIP(ip)) ip = req.getHeader("X-Real-IP");</p>
<p>if (ip == null || isPrivateIP(ip)) ip = "许昌"; // fallback</p>
</code></pre>

<p>优点：零前端改动、无需用户授权、最可靠</p>

<h4>方案二：浏览器 GPS + 逆地理编码</h4>

<p>前端通过 <code>navigator.geolocation</code> 获取经纬度 → 传给后端 → 调用 Nominatim（OpenStreetMap，免费无需 API Key）逆地理编码获取城市名 → 传给天聚数行查天气。</p>

<pre><code class="language-javascript">// 前端
navigator.geolocation.getCurrentPosition(pos => {
fetch('/api/weather?lat=' + pos.coords.latitude + '&lng=' + pos.coords.longitude);
});
</code></pre>

<pre><code class="language-java">// 后端 逆地理编码
String url = String.format(
"https://nominatim.openstreetmap.org/reverse?lat=%.6f&lon=%.6f&format=json&accept-language=zh",
lat, lng);
// 从 display_name 字段解析含"市"的层级作为城市名
</code></pre>

<p>需要处理两个问题：</p>
<p>1. Nominatim 的 <code>address.city</code> 可能返回区级（如"越秀区"），需 fallback 到 <code>display_name</code></p>
<p>2. 需要用户授权浏览器定位，拒绝授权时 fallback 默认城市</p>

<h3>总结</h3>

<h4>问题本质</h4>

<p>CDN 架构下，源站的 <code>remote_addr</code> 是倒数第二跳的 IP。<strong>如果 CDN 不在回源 header 中注入真实客户端 IP，源站永远不知道谁在访问。</strong> 这和 Nginx 配不配 <code>real_ip</code> 没关系——模块只能改写已有信息，不能凭空生成。</p>

<h4>经验分享</h4>

<ul><li>接入 CDN 后务必确认 CDN 提供了真实 IP 回源机制。EdgeOne 叫「真实客户端 IP 回源」，Cloudflare 叫「True-Client-IP Header」，阿里云 CDN 默认开启</li><li>不要假设 <code>X-Forwarded-For</code> 第一位一定是客户端 IP——取决于 CDN 是否开启了对应功能</li><li>排查这类问题最快的方法是<strong>在后端接口直接打印所有 IP 相关 header</strong>，一目了然</li><li>天气 API "根据 IP 自动定位"本质上是对传入 IP 做 GeoIP 查询，IP 是谁就定位谁——如果 IP 是 CDN 的，结果自然是 CDN 城市</li></ul>

最近没更新，在做一个名片小程序，左上角有一个天气预报模块，用的是天聚数行的天气 API，支持按城市名或传入 IP 实现自动城市定位。部署上线后出现一个奇怪的问题：不管谁访问页面，天气永远显示 CDN 边缘节点的城市，而不是访问者的真实所在地。接下来就给大家讲讲，用到的朋友们来学习一下吧

腾讯云EdgeOne加速下天聚数行天气API定位不准问题排查修复

接入腾讯云EdgeOne CDN后，天聚数行天气API始终返回边缘节点城市而非访问者真实所在地。本文从后端IP获取、Nginx real_ip模块、EdgeOne回源配置三层逐级排查，最终确认根因为CDN未开启真实客户端IP回源，并提供控制台配置和浏览器GPS定位两套解决方案

创始人

云计算

网络与通信

后端

解决CDN导致天气API定位不准问题：EdgeOne未开启真实IP回源时，后端获取的始终是CDN节点IP而非用户真实IP。推荐开启CDN真实IP回源功能，或采用前端GPS定位+逆地理编码方案。排查时需打印所有IP相关header，确认CDN是否注入了真实客户端IP。

EdgeOne

Nginx

Java

2026上云采购 | AI焕新·智启新局

CDN免费试用


文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

腾讯云EdgeOne加速下天聚数行天气API定位不准问题排查修复-腾讯云开发者社区-腾讯云

腾讯云EdgeOne加速下天聚数行天气API定位不准问题排查修复

腾讯云EdgeOne加速下天聚数行天气API定位不准问题排查修复

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐