Flask部署Ubuntu Apache后登录/注册页面持续加载无法跳转

1. 检查数据库文件/连接权限 #

如果使用SQLite作为数据库，Apache的运行用户www-data需要拥有数据库文件及所在目录的读写权限，否则认证时无法查询或写入数据导致请求阻塞：

sudo chown www-data:www-data /path/to/your/app/database.db
sudo chmod 660 /path/to/your/app/database.db
sudo chown www-data:www-data /path/to/your/app/

若使用MySQL/PostgreSQL等数据库，确认连接字符串配置正确，服务器防火墙允许数据库端口访问，且数据库用户具备足够的读写权限。

2. 确认SECRET_KEY配置有效性 #

Flask的会话管理、CSRF保护依赖SECRET_KEY，部署环境必须设置固定的强密钥，不能使用开发环境的临时值：

app.config['SECRET_KEY'] = 'your-strong-random-secret-key-here'

可通过以下命令生成安全密钥：

python -c "import secrets; print(secrets.token_hex(16))"

3. 校验Flask-WTF的CSRF配置 #

• 确保表单模板中正确渲染CSRF令牌，在<form>标签内添加：

  {{ form.hidden_tag() }}
  

• 若配置了SERVER_NAME，需确保其与部署域名一致，避免CSRF令牌域名不匹配：

  app.config['SERVER_NAME'] = 'your-domain.com'
  

4. 排查Apache WSGI配置问题 #

• 确认WSGI脚本路径正确，且www-data用户有权限读取：
  示例app.wsgi内容：

  import sys
  sys.path.insert(0, '/path/to/your/flask/app')
  from app import app as application
  

• 检查虚拟主机配置，确保未拦截POST请求，避免类似LimitExcept GET的规则限制表单提交。
• 开启详细日志定位错误，在Apache配置中添加：

  WSGILogLevel info
  ErrorLog ${APACHE_LOG_DIR}/flask_app_error.log
  CustomLog ${APACHE_LOG_DIR}/flask_app_access.log combined
  

  查看日志内容：

  tail -f /var/log/apache2/flask_app_error.log
  

5. 检查表单提交路径与路由配置 #

• 确保表单action属性使用正确的路由，避免相对路径错误：

  <form method="POST" action="{{ url_for('login') }}">
  

• 确认登录/注册路由装饰器包含POST方法：

  @app.route('/login', methods=['GET', 'POST'])
  def login():
      # 视图逻辑
  

6. 定位代码阻塞点 #

在登录/注册视图的关键环节添加日志，排查是否存在死锁或阻塞操作：

import logging
logging.basicConfig(filename='/var/log/flask_app.log', level=logging.INFO)

@app.route('/login', methods=['GET', 'POST'])
def login():
    logging.info('Login endpoint accessed')
    form = LoginForm()
    if form.validate_on_submit():
        logging.info('Form validation passed, starting user lookup')
        # 后续认证逻辑

通过日志输出定位请求卡住的具体阶段。

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