因PostHog超大Cookie导致Nginx返回400错误的技术求助

1. 切换PostHog存储方式至localStorage/sessionStorage #

PostHog默认用Cookie存储用户标识与会话信息，可在初始化时指定存储方式规避Cookie膨胀问题：

import { PostHogProvider } from 'posthog-js/react';

function App() {
  return (
    <PostHogProvider
      apiKey="YOUR_API_KEY"
      options={{
        api_host: 'https://app.posthog.com',
        storage: 'localStorage', // 也可选择'sessionStorage'
      }}
    >
      {/* 应用组件内容 */}
    </PostHogProvider>
  );
}

此设置会将用户ID、会话信息存入localStorage，不再占用Cookie空间，从根源解决Cookie过大问题。

2. 自动清理旧PostHog Cookie #

若需保留Cookie存储，可通过初始化配置缩短Cookie有效期，同时在应用入口主动清理旧Cookie：

// PostHog初始化配置
options={{
  persistence_duration: 7 * 24 * 60 * 60, // 将Cookie有效期设为7天（默认周期更长）
  clear_opted_out_cookies: true, // 自动清理已退出用户的Cookie
}}

// 应用入口处主动清理旧PostHog Cookie
document.cookie.split(";").forEach(cookie => {
  if (cookie.trim().startsWith('ph___')) {
    const name = cookie.split('=')[0].trim();
    document.cookie = `${name}=; expires=Thu, 01 Jan 1970 00:00:00 UTC; path=/;`;
  }
});

这段代码会自动清理用户浏览器中遗留的旧PostHog Cookie，无需用户手动操作。

3. 降低会话重放采样率 #

若当前会话重放采样率为100%，可降低采样率减少会话数据生成，避免Cookie内会话ID列表快速膨胀：

options={{
  session_recording: {
    sampling_rate: 30, // 仅录制30%的用户会话
  },
}}

4. 禁用不必要的Cookie字段 #

如果无需多会话追踪，可禁用会话ID存储或仅保留必要字段（注意：此设置会影响会话重放的关联逻辑，需结合业务需求判断）：

options={{
  capture_session: false, // 禁用会话追踪，仅保留用户ID
}}

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