Sentry捕获Cloudflare IP而非客户端IP的问题求助

问题背景 #

• Sentry集成功能正常，但日志捕获的是Cloudflare IP而非客户端真实IP
• 目标：让Sentry日志显示客户端真实IP

已尝试操作 #

• 通过Cloudflare Worker的HTML Rewriter获取cf-connecting-ip或x-real-ip（客户端真实IP），注入到页面DOM中
• 前端代码配置Sentry：

Sentry.setUser({
     ip_address: document.querySelector("[data-key=ip]")?.innerHTML.trim()
});

当前问题 #

已成功获取客户端IP，但Sentry仍记录Cloudflare IP，不确定是Sentry.setUser的ip_address参数用法错误，还是遗漏了Cloudflare相关配置。

解决方案 #

1. 确认ip_address参数的调用时机 #

Sentry.setUser中的ip_address字段用法正确，但必须在Sentry初始化完成后、任何错误发生前调用。如果调用时机过晚（比如错误已上报后才设置），IP不会被更新。

2. 初始化时通过全局配置直接设置IP #

跳过DOM查询，在Sentry初始化时用beforeSend钩子覆盖IP：

// 假设已通过Worker拿到客户端IP，存储在window.__CLIENT_IP__中
const clientIp = window.__CLIENT_IP__;
Sentry.init({
  dsn: '你的DSN地址',
  beforeSend(event) {
    // 确保用户对象存在，再设置IP
    event.user = event.user || {};
    event.user.ip_address = clientIp;
    return event;
  }
});

3. 优化Cloudflare Worker的IP传递方式 #

不用HTML Rewriter往DOM里插入IP，直接在Worker中给页面头部添加全局变量脚本，更可靠：

// Cloudflare Worker代码示例
addEventListener('fetch', event => {
  event.respondWith(handleRequest(event.request));
});

async function handleRequest(request) {
  const response = await fetch(request);
  const clientIp = request.headers.get('cf-connecting-ip');
  // 在页面head最前端插入全局变量脚本
  return new HTMLRewriter()
    .on('head', {
      element(element) {
        element.prepend(`<script>window.__CLIENT_IP__ = "${clientIp}";</script>`, {html: true});
      }
    })
    .transform(response);
}

前端直接读取window.__CLIENT_IP__即可，无需查询DOM元素。

4. 检查Sentry默认IP捕获逻辑 #

前端上报时，Sentry默认会捕获浏览器连接的IP（即Cloudflare IP），通过setUser设置的ip_address会覆盖默认值，但需注意：

• 不要让后续代码覆盖用户对象
• Sentry默认开启用户IP捕获，不要在配置中禁用该功能

内容的提问来源于stack exchange，提问作者Shinjo