如何在本地测试基于django-tenant-schemas的多租户Django应用

我之前做多租户项目时也碰到过一模一样的本地测试难题，结合django-tenant-schemas的核心逻辑，给你几个落地可行的解决方案：

1. 修正hosts配置并刷新DNS缓存 #

先检查你的hosts文件格式是否正确，必须每行单独绑定一个域名，以Mac/Linux的/etc/hosts或Windows的C:\Windows\System32\drivers\etc\hosts为例，正确写法是：

127.0.0.1   localhost
127.0.0.1   client.localhost
127.0.0.1   test-client.localhost

写完后一定要刷新DNS缓存，不然系统可能还会用旧的解析：

• Mac终端执行：sudo dscacheutil -flushcache; sudo killall -HUP mDNSResponder
• Windows管理员命令提示符执行：ipconfig /flushdns
• Linux执行：sudo systemctl restart systemd-resolved（根据系统不同可能略有差异）

2. 调整Django开发服务器监听范围 #

默认的Django开发服务器只监听127.0.0.1，你需要让它监听所有网络接口，这样子域名请求才能被捕获：

python manage.py runserver 0.0.0.0:8000

3. 确保租户的domain_url配置匹配本地环境 #

在创建测试租户时，必须带上端口号（生产环境用80/443端口不需要，但本地开发用8000端口必须加），比如租户的domain_url字段要设置为client.localhost:8000，而不是单纯的client.localhost。这样django-tenant-schemas的TenantMiddleware才能正确匹配请求的Host头。

4. 用Nginx反向代理模拟生产无端口访问（可选） #

如果想完全复刻生产环境的无端口访问体验，可以用Nginx做反向代理：

1. 安装Nginx（Mac用brew install nginx，Ubuntu用sudo apt install nginx）
2. 创建Nginx配置文件（比如/usr/local/etc/nginx/servers/tenant-dev.conf），内容如下：

server {
    listen 80;
    server_name localhost;

    location / {
        proxy_pass http://127.0.0.1:8000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

server {
    listen 80;
    server_name client.localhost;

    location / {
        proxy_pass http://127.0.0.1:8000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

3. 重启Nginx生效：sudo nginx -s reload
4. 现在你可以直接访问http://localhost和http://client.localhost，完全模拟生产环境的子域名访问逻辑。

5. 快速排查验证步骤 #

如果还是无法访问，可以用以下方式定位问题：

• 执行ping client.localhost，确认是否解析到127.0.0.1
• 用curl测试Host头传递：curl -H "Host: client.localhost:8000" http://127.0.0.1:8000，查看返回内容是否对应目标租户的页面
• 查看Django运行日志，确认请求进来时是否正确识别了对应的租户schema

内容的提问来源于stack exchange，提问作者NG.