Firefox 默认启用“增强型跟踪保护（ETP）”和“总 Cookie 保护（Total Cookie Protection）”，当检测到第三方上下文或隐私敏感设置（如 SameSite=None; Secure）时，会自动将未明确标记为第一方且缺乏充分信任信号的 Cookie 过期时间截断为 7 天——即使代码中设置了更长有效期。
firefox 浏览器中 cookie 过期时间被强制限制为 7 天的解决方案：firefox 默认启用“增强型跟踪保护（etp）”和“总 cookie 保护（total cookie protection）”，当检测到第三方上下文或隐私敏感设置（如 `samesite=none; secure`）时，会自动将未明确标记为第一方且缺乏充分信任信号的 cookie 过期时间截断为 7 天——即使代码中设置了更长有效期。
在开发跨浏览器兼容的 Cookie 管理逻辑时，你可能会遇到这样一个典型问题：使用 document.cookie 设置 max-age 或 expires 为一年（例如 max-age=31536000），Chrome 中表现正常，但 Firefox 却始终将实际过期时间覆盖为 7 天（604800 秒），且控制台与开发者工具中无任何警告。
这并非 Bug，而是 Firefox 自 2021 年起逐步推行的隐私保护机制——Total Cookie Protection（总 Cookie 保护） 的副作用。该机制会对“非第一方上下文”或“被广告拦截器/隐私扩展标记为可疑”的 Cookie 实施严格生命周期限制，其中最常见触发条件包括：
- 设置 SameSite=None; Secure（常用于跨站请求，但需 HTTPS + 显式声明）
- 在 iframe、弹窗或重定向后上下文中写入 Cookie
- 浏览器识别为潜在跟踪行为（如无用户交互直接设置）
✅ 根本原因验证方式：
打开 Firefox 地址栏输入 about:preferences#privacy → 检查是否启用了「增强型跟踪保护」（Enhanced Tracking Protection）→ 尝试临时切换为「标准」或「自定义」并禁用「Cookie 隔离」；同时关闭所有广告拦截插件（如 uBlock Origin、Privacy Badger）。许多开发者反馈：仅禁用 Ad Blocker 后，Cookie 即恢复预期过期时间。
? 可靠解决方案（按优先级排序）：
-
确保第一方上下文 + 用户交互触发
Cookie 应在用户显式操作（如点击按钮、提交表单）后设置，避免在页面加载初期静默写入：document.getElementById('consent-accept').addEventListener('click', () => { document.cookie = "consent=true; max-age=31536000; path=/; SameSite=Lax; Secure"; });✅ 推荐 SameSite=Lax（默认值）替代 None，除非确需跨站发送。Lax 既保障安全性，又避免触发 Total Cookie Protection 的严控逻辑。
-
避免不必要的 SameSite=None; Secure 组合
若 Cookie 仅用于同站请求（90% 场景），完全无需 SameSite=None。错误使用该组合反而向 Firefox 发出“我可能是第三方跟踪器”的信号：// ❌ 不推荐（易触发 7 天截断） document.cookie = "theme=dark; max-age=31536000; SameSite=None; Secure"; // ✅ 推荐（安全且兼容） document.cookie = "theme=dark; max-age=31536000; path=/; Secure"; // SameSite=Lax 自动生效，HTTPS 环境下 Secure 合法
-
服务端 Cookie 设置（终极兼容方案）
前端 document.cookie 受浏览器策略限制较多；改用 HTTP 响应头设置更可控：Set-Cookie: session_id=abc123; Max-Age=31536000; Path=/; Secure; HttpOnly; SameSite=Lax
此方式不受前端脚本执行环境影响，且 Firefox 对响应头设置的 Cookie 生命周期限制更宽松。
⚠️ 注意事项：
- max-age 和 expires 不可同时设置，后者会被忽略；优先使用 max-age（秒级整数，更可靠）。
- Firefox 115+ 版本进一步强化了对 SameSite=None 的校验：若未配 Secure，或在非 HTTPS 环境下设置，Cookie 将直接被拒绝，而非降级为 7 天。
- 开发调试时，务必在 无扩展干扰的隐私窗口（Ctrl+Shift+P） 中验证，排除插件干扰。
总结：Firefox 的 7 天 Cookie 截断是主动隐私防护策略，而非缺陷。通过回归第一方语义、精简 Cookie 属性、结合服务端设置，并规避广告拦截器干扰，即可实现与 Chrome 一致的长期存储效果。
