Flask渲染个人资料页时出现500内部服务器错误求助

一、个人资料页500错误的问题诊断与修复 #

1. 缺失current_user导入 #

app.py的profile路由中使用了current_user对象，但未从flask_login库导入该对象，导致服务器抛出未定义错误。

修复方案：
在app.py的导入段添加current_user：

from flask_login import LoginManager, login_user, logout_user, login_required, UserMixin, current_user

2. 模板变量引用错误 #

profile.html中直接调用current_user.username、current_user.name等属性，但自定义的User类仅包含id属性，这些属性并不存在；同时模拟数据库中没有location字段，模板引用会触发不存在字段错误。

修复方案：
修改profile.html，使用路由传入的user变量获取数据，并移除不存在的location字段：

{% extends 'base.html' %}

{% block title %}Profile{% endblock %}

{% block content %}
  <div class="profile-container">
    <div class="profile-header">
      <img src="{{ url_for('static', filename='img/profile-pic.jpg') }}" alt="Profile Picture" class="profile-picture">
      <h1>{{ user.id }}</h1>
    </div>
    <div class="profile-info">
      <h2>Profile Information</h2>
      <ul>
        <li><strong>Name:</strong> {{ user.name }}</li>
        <li><strong>Email:</strong> {{ user.email }}</li>
      </ul>
    </div>
  </div>
{% endblock %}

{% block scripts %}
  <script src="{{ url_for('static', filename='js/profile.js') }}"></script>
{% endblock %}

二、切换到本地数据库的建议（SQLite + Flask-SQLAlchemy） #

1. 安装依赖 #

pip install flask-sqlalchemy

2. 重构app.py配置数据库与模型 #

from flask import Flask, render_template, request, redirect, url_for, flash
from flask_login import LoginManager, login_user, logout_user, login_required, UserMixin, current_user
from flask_bcrypt import Bcrypt
from flask_sqlalchemy import SQLAlchemy

app = Flask(__name__)
app.secret_key = 'kO=:6KafW}GT~~l[rle/;yAyE_nAQ^'
# 配置SQLite数据库，文件自动生成在项目根目录
app.config['SQLALCHEMY_DATABASE_URI'] = 'sqlite:///users.db'
app.config['SQLALCHEMY_TRACK_MODIFICATIONS'] = False

bcrypt = Bcrypt(app)
db = SQLAlchemy(app)

# 配置Flask-Login
login_manager = LoginManager()
login_manager.init_app(app)
login_manager.login_view = 'login'

# 定义User数据库模型
class User(UserMixin, db.Model):
    id = db.Column(db.String(50), primary_key=True) # 用户名作为主键
    password = db.Column(db.String(200), nullable=False)
    name = db.Column(db.String(100), nullable=False)
    email = db.Column(db.String(100), nullable=False)

    def __repr__(self):
        return self.id

# 从数据库加载用户
@login_manager.user_loader
def load_user(user_id):
    return User.query.get(user_id)

# 登录路由适配数据库查询
@app.route('/login', methods=['GET', 'POST'])
def login():
    if request.method == 'POST':
        user = User.query.get(request.form['username'])
        if user and bcrypt.check_password_hash(user.password, request.form['password']):
            login_user(user)
            flash('Logged in successfully.')
            return redirect(url_for('index'))
        else:
            flash('Invalid username or password.')
    return render_template('login.html')

# 登出、首页、个人资料路由保持不变

# 初始化数据库与测试数据（首次运行时执行）
with app.app_context():
    db.create_all()
    # 仅在无数据时初始化测试用户
    if not User.query.get('user1'):
        user1 = User(
            id='user1',
            password=bcrypt.generate_password_hash('password').decode('utf-8'),
            name='John Doe',
            email='john.doe@example.com'
        )
        user2 = User(
            id='user2',
            password=bcrypt.generate_password_hash('password2').decode('utf-8'),
            name='Jane Smith',
            email='jane.smith@example.com'
        )
        db.session.add(user1)
        db.session.add(user2)
        db.session.commit()

if __name__ == '__main__':
    app.run(debug=True)

3. 后续扩展提示 #

• 若需切换到MySQL或PostgreSQL，仅需修改SQLALCHEMY_DATABASE_URI为对应数据库连接字符串
• 生产环境建议使用Flask-Migrate管理数据库模型变更，避免手动修改表结构

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