问题概述
在使用 dj-rest-auth 实现邮箱验证功能时，开发者可能会遇到一个常见问题：在本地开发环境中，验证邮件的 URL 生成正常，但部署到生产环境后，URL 却出现错误，例如域名不正确或指向了错误的地址。常见的错误 URL 可能是 http://backend/accounts/confirm-email/...，其中 http://backend/ 显然不是期望的生产环境域名。
根本原因在于 Django 的 Sites 框架配置不正确。 dj-rest-auth 依赖 Django Sites 框架来生成邮件中的绝对 URL。如果 Sites 框架没有配置正确的域名和站点信息，就会导致生成的 URL 出现错误。
解决方案
以下步骤详细介绍了如何排查和解决此问题：
-
检查 Django Sites 框架配置:
首先，确认 django.contrib.sites 应用已添加到 INSTALLED_APPS 中：
INSTALLED_APPS = [ ... 'django.contrib.sites', ... ]然后，确保 settings.py 中定义了 SITE_ID：
SITE_ID = 1
这个 SITE_ID 对应的是数据库中 django_site 表中的记录。
-
配置 Sites 框架:
使用 Django 管理后台或 shell 命令，进入 django_site 表，找到 SITE_ID 对应的记录，并确保 domain 和 name 字段设置为正确的生产环境域名和站点名称。
使用 Django 管理后台: 登录 Django 管理后台，找到 "Sites" 应用，编辑 SITE_ID 对应的站点，设置正确的域名。
-
使用 Django shell:
from django.contrib.sites.models import Site site = Site.objects.get(pk=1) # 假设 SITE_ID = 1 site.domain = 'your_production_domain.com' site.name = 'Your Production Site Name' site.save()
重要提示: 确保 domain 字段包含完整的域名，例如 your_production_domain.com，不要包含协议头 (http/https) 或路径。
-
清除缓存:
修改 Sites 框架配置后，建议清除 Django 的缓存，以确保配置生效。
from django.core.cache import cache cache.clear()
如果使用了其他缓存机制，也需要清除相应的缓存。
-
重启服务器:
完成配置修改和缓存清除后，重启 Django 服务器，使配置生效。
示例代码
以下代码片段展示了如何在 Django shell 中配置 Sites 框架：
from django.contrib.sites.models import Site
# 获取 SITE_ID 为 1 的站点
site = Site.objects.get(pk=1)
# 设置正确的域名和站点名称
site.domain = 'your_production_domain.com'
site.name = 'Your Production Site Name'
# 保存修改
site.save()
print(f"站点域名已更新为: {site.domain}")注意事项:
- 确保 your_production_domain.com 替换为实际的生产环境域名。
- 如果使用了多个站点，需要为每个站点配置正确的域名。
- 在修改 Sites 框架配置后，务必清除缓存并重启服务器。
总结
解决 dj-rest-auth 邮箱验证 URL 错误的关键在于正确配置 Django 的 Sites 框架。通过检查并配置 django_site 表中的 domain 和 name 字段，可以确保 dj-rest-auth 生成的验证邮件 URL 指向正确的生产环境域名。遵循本文提供的步骤，可以有效地排查和解决此问题，确保邮件验证功能在生产环境中正常运行。
