在这篇文章中，我想与大家分享我使用 Django Allauth 无头（Headless）后端认证，与 TanStack Start前端结合使用的经验和心得。我今年才刚刚学习 Web 编程，定有不少错漏，还望读者指正。
演示项目代码库
https://github.com/sd44/django-allauth
项目背景
Life is short, you need Python
虽然目前前后端分离架构正被 TypeScript 一体化框架（如Next.js/Tanstack Start等）冲击，特别是在要求全栈协作、类型一致性、小团队敏捷项目上，但我仍爱 Python Django 的简洁清晰、快速开发和易于维护。本文无意也无力讨论架构的优劣，就此打住吧。
Django Allauth 与 NextAuth.js, Better Auth都提供多种认证方式（如手机号码、邮箱、通行密钥、数十种社交账户认证等）。但官方 Allauth Headless + React SPA示例仍然是 JS，而非 TS 代码；网络上也缺乏Allauth 对接 Tanstack/Next SSR前端的教程。本文便由此而生，但限于篇幅，只提出个别避坑指南，并不完整。