Django提交表单时偶发CSRF cookie缺失问题该如何处理？

以下是针对已添加{% csrf_token %}但仍偶发报错、清除Cookie后临时恢复的场景的对应解决方案：

• 调整CSRF Cookie有效期配置
  检查项目settings.py中的CSRF_COOKIE_AGE参数，默认值为31449600秒（1年），如果你手动设置了较短的过期时间，用户打开表单页面后停留过久超过Cookie有效期，提交时就会出现token不匹配问题。无需严格限制有效期的场景可以保持默认值，或设置为None让Cookie随浏览器会话结束自动失效。
  如果你开启了CSRF_USE_SESSIONS配置（将CSRF token存在Session中而非Cookie），需要同步检查SESSION_COOKIE_AGE的有效期配置，避免Session过期导致token校验失败。
• 禁用表单页面的缓存策略
  如果表单页面开启了服务端静态缓存、CDN缓存，不同用户访问时会拿到包含固定CSRF token的同一份页面，和用户本地的CSRF Cookie无法匹配。可以给表单对应的视图添加@never_cache装饰器完全禁用页面缓存，或使用片段缓存功能单独排除表单渲染部分。
• 修正跨域/多子域名部署配置
  涉及跨域请求或者同根域名多子域名部署的场景，需要补充两项配置：
  1. 在CSRF_TRUSTED_ORIGINS中添加所有允许提交表单的来源域名，需携带完整的http/https前缀，示例：CSRF_TRUSTED_ORIGINS = ["https://shop.example.com", "https://admin.example.com"]
  2. 多子域名共用的场景下设置CSRF_COOKIE_DOMAIN为根域名，示例：CSRF_COOKIE_DOMAIN = ".example.com"，保证所有子域名都能读取到正确的CSRF Cookie。
• 修正AJAX提交的token携带逻辑
  通过AJAX提交表单时，仅在HTML中添加{% csrf_token %}无法完成校验，需要主动在请求头中携带X-CSRFToken参数，可参考以下全局配置代码：

  // 从Cookie读取CSRF token
  function getCookie(name) {
      let cookieValue = null;
      if (document.cookie && document.cookie !== '') {
          const cookies = document.cookie.split(';');
          for (let i = 0; i < cookies.length; i++) {
              const cookie = cookies[i].trim();
              if (cookie.substring(0, name.length + 1) === (name + '=')) {
                  cookieValue = decodeURIComponent(cookie.substring(name.length + 1));
                  break;
              }
          }
      }
      return cookieValue;
  }
  const csrftoken = getCookie('csrftoken');
  // 发送POST请求时携带头信息
  fetch(提交接口地址, {
      method: 'POST',
      headers: {
          'X-CSRFToken': csrftoken,
          'Content-Type': 'application/json'
      },
      body: JSON.stringify(请求参数)
  })
  

• 优化多账号登录场景的兼容逻辑
  用户在同个浏览器多标签页登录不同账号时，新登录账号的CSRF Cookie会覆盖旧标签页对应的Cookie，导致旧标签页表单提交失败。可以在页面加载时用JS动态更新表单中CSRF token的输入值，或在捕获到CSRF报错时自动刷新页面获取最新的token，减少用户操作成本。
• 检查自定义认证逻辑的Cookie操作
  排查你的自定义登录、登出逻辑中是否存在手动删除、修改csrftoken Cookie的代码，避免逻辑执行后Cookie和页面中已渲染的token不匹配。

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