部署服务器上Django通过HTTPS/SSL登录失败问题求助

根据你描述的症状——点击登录后无授权操作、刷新回登录页，结合你的配置代码，大概率是HTTPS环境下的请求头传递、Cookie配置或静态/模板路径问题导致的，以下是逐步排查和修复方案：

1. 修复Nginx配置：正确传递HTTPS请求头给uWSGI #

你的Nginx配置中使用了uwsgi_pass，但错误地用了proxy_set_header（这是给反向代理HTTP用的），uWSGI需要用uwsgi_param传递请求头，特别是关键的X-Forwarded-Proto，让Django识别当前是HTTPS环境。修改后的配置如下：

# 新增HTTP重定向到HTTPS的server块，避免HTTP访问引发的问题
server {
    listen 80;
    server_name tekis.biz;
    return 301 https://$server_name$request_uri;
}

# 原HTTPS server块修改
upstream django {
    server 127.0.0.1:8001;
}

server {
    listen 443 ssl;
    ssl_certificate /etc/letsencrypt/live/tekis.biz/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/tekis.biz/privkey.pem;
    server_name tekis.biz;
    charset utf-8;
    client_max_body_size 75M;

    # 静态文件指向collectstatic后的STATIC_ROOT目录
    location /static {
        alias /home/teranori/invoice/static/;  # 对应settings.py里的STATIC_ROOT
    }

    location / {
        uwsgi_pass django;
        include /home/teranori/invoice/uwsgi_params;
        # 替换proxy_set_header为uwsgi_param，新增X-Forwarded-Proto
        uwsgi_param Host $http_host;
        uwsgi_param X-Real-IP $remote_addr;
        uwsgi_param X-Forwarded-For $proxy_add_x_forwarded_for;
        uwsgi_param X-Forwarded-Proto $scheme;  # 关键：告诉Django当前是HTTPS环境
    }
}

2. 修正settings.py中的关键配置 #

2.1 修复静态文件和模板路径错误 #

你的配置存在重复定义和路径错误，修改如下：

# 删除重复的STATIC_URL定义，保留正确的配置
STATIC_URL = '/static/'
# STATIC_ROOT已正确，确保执行过collectstatic命令
STATIC_ROOT = os.path.join(BASE_DIR, 'static/')

# 修正TEMPLATES的DIRS配置，避免重复覆盖
TEMPLATES = [
    {
        'BACKEND': 'django.template.backends.django.DjangoTemplates',
        # 如果项目根目录有templates文件夹则使用该路径；否则依赖APP_DIRS=True自动加载app内的templates
        'DIRS': [os.path.join(BASE_DIR, 'templates')],
        'APP_DIRS': True,
        'OPTIONS': {
            'context_processors': [
                'django.template.context_processors.debug',
                'django.template.context_processors.request',
                'django.contrib.auth.context_processors.auth',
                'django.contrib.messages.context_processors.messages',
                # 移除未使用的social_django上下文处理器（未安装该库时无需保留）
            ],
        },
    },
]

# 删除过时的TEMPLATE_LOADERS配置（Django 1.11已不再推荐，由TEMPLATES配置替代）
# TEMPLATE_LOADERS = (...)

2.2 确保HTTPS相关配置生效 #

你的SECURE_PROXY_SSL_HEADER已配置，但需配合Nginx的X-Forwarded-Proto传递才能生效，同时检查以下配置：

# 保持这些配置，确保Cookie仅在HTTPS下传输
SESSION_COOKIE_SECURE = True
CSRF_COOKIE_SECURE = True
SECURE_PROXY_SSL_HEADER = ('HTTP_X_FORWARDED_PROTO', 'https')
SECURE_SSL_REDIRECT = True

# 生产环境建议关闭DEBUG模式
DEBUG = False

3. 验证登录模板的CSRF令牌 #

确保invo/login.html模板中包含CSRF令牌，否则会导致CSRF验证失败，登录请求被拒绝：

<form method="post" action="{% url 'invo:login' %}">
    {% csrf_token %}
    <!-- 其他表单字段 -->
    <button type="submit">登录</button>
</form>

4. 执行必要的部署操作 #

• 运行python manage.py collectstatic收集静态文件到STATIC_ROOT目录
• 重启Nginx：sudo systemctl restart nginx
• 重启uWSGI服务（根据你的启动方式，比如sudo systemctl restart uwsgi）
• 查看Django日志（如tail -f /var/log/uwsgi/app/your_project.log），排查是否有CSRF或session相关的错误信息

5. 额外排查点 #

• 确认AUTH_USER_MODEL = 'invo.InvoUser'对应的模型正确继承了AbstractUser，且已执行数据库迁移（python manage.py makemigrations和migrate）
• 检查数据库中用户表的密码是否正确（可通过python manage.py createsuperuser创建测试用户尝试登录）

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