Django视图无法读取前端document.cookie设置的Cookie问题咨询

• 作用域配置错误：JS默认设置Cookie时如果不显式指定path和domain参数的话，Cookie默认仅对当前页面路径、当前完整域名生效。比如你在/list/路径下设置的Cookie，默认path为/list/，请求/detail/路径的接口时不会携带该Cookie；如果前后端部署在不同子域名下时也会出现相同问题。
• 跨域请求限制：前后端部署在不同域名、端口下时属于跨域场景，浏览器默认不会自动携带第三方Cookie，除非两端都做了兼容配置。
• 安全属性限制：如果Cookie设置了Secure属性，仅HTTPS请求会携带该Cookie；如果设置了SameSite=Strict/SameSite=Lax属性，跨站请求也不会携带。
• 取值写法问题：直接使用request.COOKIES['name']取值时，如果Cookie不存在会直接抛出KeyError，建议先用request.COOKIES.get('name')更稳妥，也可以排查是否是Cookie名拼写、大小写不匹配的问题。

• 需持久化存储的全局参数：使用Cookie时要显式配置全量参数，JS设置示例：document.cookie = "name=tom; path=/; SameSite=Lax;"，确保全站可访问；跨域场景下额外配置：
  • 前端请求开启凭证携带：axios设置withCredentials: true，fetch设置credentials: 'include'
  • Django端安装django-cors-headers，配置CORS_ALLOW_CREDENTIALS = True，CORS_ALLOWED_ORIGINS添加前端访问地址，不可使用通配符*
• 单次请求临时参数：不需要持久化的参数直接放在请求链路中传递，GET请求放在Query参数，POST请求放在请求体中，逻辑更直观，也避免Cookie的作用域限制问题。
• Django模板内嵌变量传递：如果是服务端渲染模板的场景，直接把后端变量注入模板即可，普通变量直接写const name = "{{ name }}";，结构化数据使用Django内置的json_script模板标签：{{ data_dict|json_script:"page_data"}}，JS侧取值const pageData = JSON.parse(document.getElementById('page_data').textContent)即可，可规避XSS风险。

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