生产环境下Django Allauth登录/注册因SMTPAuthenticationError(535)失败问题排查求助

首先来看你遇到的核心错误：

SMTPAuthenticationError: (535, b'Incorrect authentication data')

对应的回溯信息：

File ".../django/core/mail/backends/smtp.py", line 97, in open
    self.connection.login(self.username, self.password)
File ".../smtplib.py", line 669, in auth
    raise SMTPAuthenticationError(code, resp)

环境信息 #

• Django：6.0.3
• Python：3.14.3
• django-allauth：最新版本
• 部署方式：cPanel（Passenger）
• 操作系统：Linux（基于RHEL）

当前配置 #

邮件配置 #

EMAIL_BACKEND = 'django.core.mail.backends.smtp.EmailBackend'
EMAIL_HOST = 'mail.agrotekpluss.com'
EMAIL_PORT = 587
EMAIL_USE_TLS = True
EMAIL_USE_SSL = False
EMAIL_HOST_USER = config('EMAIL_HOST_USER')
EMAIL_HOST_PASSWORD = config('EMAIL_HOST_PASSWORD')
DEFAULT_FROM_EMAIL = 'atpsus@agrotekpluss.com'

Allauth配置 #

ACCOUNT_EMAIL_VERIFICATION = "mandatory"
ACCOUNT_LOGIN_METHODS = {'email'}
ACCOUNT_SIGNUP_FIELDS = ['email*', 'password1*', 'password2*']

问题复现与表现 #

复现步骤 #

1. 访问/accounts/login/或注册页面
2. 提交有效凭据
3. Allauth尝试发送验证邮件
4. 请求因SMTPAuthenticationError失败

实际行为 #

• 登录/注册流程中断失败
• 验证邮件未发送
• SMTP认证阶段抛出异常

预期行为 #

• 用户成功完成登录或注册
• 验证邮件正常发送至用户邮箱

已观察到的关键细节 #

• 仅生产环境出现该问题，本地环境完全正常
• 仅当Allauth需要发送验证邮件时触发（即ACCOUNT_EMAIL_VERIFICATION = "mandatory"时）
• 禁用邮件验证（设为"optional"）后，登录功能可正常使用

可能的原因分析与调试修复指导 #

1. SMTP凭据错误或环境变量加载失败 #

这是最常见的原因——毕竟本地环境正常，说明你的配置逻辑没问题，大概率是生产环境的凭据没配对：

• 环境变量未正确加载：cPanel的Passenger部署有时候不会自动加载你设置的环境变量，或者加载顺序有问题。你可以临时在settings.py里添加日志（不要提交到代码库！）来确认：

  import logging
  logger = logging.getLogger(__name__)
  # 只打印用户名和密码长度，避免泄露敏感信息
  logger.info(f"Loaded EMAIL_HOST_USER: {EMAIL_HOST_USER}")
  logger.info(f"EMAIL_HOST_PASSWORD length: {len(EMAIL_HOST_PASSWORD) if EMAIL_HOST_PASSWORD else 0}")
  

  然后查看Django的应用日志（cPanel的Error Logs或应用目录下的log文件夹），确认是否读取到了正确的凭据。
• 凭据本身错误：可能生产环境的邮箱密码和本地不一样，或者你在cPanel里修改了邮箱密码但没更新环境变量。另外，确认EMAIL_HOST_USER是完整的邮箱地址（比如atpsus@agrotekpluss.com），有些SMTP服务器不支持仅用户名登录。
• 特殊字符转义问题：如果密码里包含$、!、@这类特殊字符，在cPanel设置环境变量时可能需要用引号包裹，否则会被解析错误。

2. SMTP主机/加密配置与cPanel要求不匹配 #

虽然你的配置看起来是对的（587端口+TLS），但不同cPanel主机可能有特殊要求：

• 登录cPanel的Email Accounts页面，找到你的邮箱账户，点击Connect Devices，查看官方给出的SMTP配置参数，确认主机、端口、加密方式是否和你Django里的设置完全一致。
• 有些主机可能要求SMTP主机使用ssl://mail.agrotekpluss.com（但587端口一般用TLS，不用SSL前缀），或者端口不是587，务必以cPanel给出的官方配置为准。

3. cPanel邮箱账户的SMTP访问限制 #

• 账户锁定：如果多次尝试错误的SMTP凭据，cPanel可能会临时锁定该邮箱的SMTP访问权限。你可以在cPanel的Email Accounts里查看账户状态，或者在Mail Logs里搜索你的邮箱地址，看看有没有锁定相关的日志。
• SMTP访问未启用：部分cPanel主机默认禁用邮箱账户的SMTP访问，需要手动开启。在Email Accounts里找到你的账户，点击Manage，检查是否有SMTP Access的开关，确保它是开启状态。

4. Django/Python版本兼容性（可能性极低） #

你用的Django 6.0.3和Python 3.14.3都是比较新的版本，但既然本地环境用相同版本没问题，那版本兼容的可能性很小。不过你可以在生产环境用纯Python脚本测试SMTP连接，排除Django的影响：

import smtplib
from email.mime.text import MIMEText

def test_smtp():
    try:
        server = smtplib.SMTP('mail.agrotekpluss.com', 587)
        server.starttls()
        # 替换成你的实际凭据
        server.login('atpsus@agrotekpluss.com', 'your_production_password')
        msg = MIMEText('SMTP连接测试邮件')
        msg['Subject'] = 'SMTP Test'
        msg['From'] = 'atpsus@agrotekpluss.com'
        msg['To'] = 'your_test_email@example.com'
        server.sendmail('atpsus@agrotekpluss.com', ['your_test_email@example.com'], msg.as_string())
        server.quit()
        print("SMTP测试成功！")
    except Exception as e:
        print(f"SMTP测试失败：{str(e)}")

test_smtp()

如果这个脚本也报错，那问题出在SMTP服务器或凭据，和Django/Allauth无关；如果成功，那问题就出在Django的环境变量读取或配置上。

5. Allauth与SMTP发件地址的匹配要求 #

有些SMTP服务器要求发件地址（DEFAULT_FROM_EMAIL）必须和登录的邮箱（EMAIL_HOST_USER）完全一致，否则会拒绝认证。确认你的DEFAULT_FROM_EMAIL和EMAIL_HOST_USER是同一个邮箱地址。

总结调试步骤 #

1. 用上面的纯Python脚本在生产环境测试SMTP连接，确认凭据和服务器设置是否正常。
2. 检查生产环境的环境变量是否正确加载，凭据是否和本地一致。
3. 对照cPanel官方的SMTP配置参数，确认你的Django邮件配置没有错配。
4. 检查cPanel邮箱账户的状态，确保SMTP访问未被锁定或禁用。

内容的提问来源于stack exchange，提问作者snipher marube