当前位置：首页 > news >正文

第6篇、Flask 表单处理与用户认证完全指南：从零到实战

news 2025/9/27 5:50:20

标签：Python Flask Web开发 表单验证 Session Cookie 用户认证 安全编程

🎯 为什么选择这篇文章？

在Web开发的世界里，表单处理和用户认证是每个开发者必须掌握的核心技能。无论是构建电商网站、社交平台还是企业管理系统，都离不开用户登录、数据提交、状态保持这些基础功能。

Flask作为Python最轻量级的Web框架，以其简洁优雅的设计理念，让开发者能够快速构建功能完整的Web应用。本文将带你从零开始，深入理解Flask的表单处理机制，掌握Session和Cookie的使用技巧，最终构建一个完整的用户认证系统。

🎉 学完本文，你将能够：

✅ 熟练处理HTML表单数据
✅ 使用WTForms构建强大的表单验证
✅ 实现安全的用户认证系统
✅ 掌握Session和Cookie的最佳实践
✅ 理解Web安全的核心概念

📑 目录导航

章节	内容	难度	预计时间
1. 基础入门	HTML表单处理	⭐	3分钟
2. 进阶技巧	WTForms表单验证	⭐⭐	5分钟
3. 安全防护	自定义验证与CSRF	⭐⭐⭐	4分钟
4. 状态管理	Session与Cookie	⭐⭐	3分钟
5. 实战项目	完整认证系统	⭐⭐⭐⭐	10分钟

1. 基础入门：HTML表单与Flask的完美配合

🎯 学习目标

掌握Flask处理HTML表单的基本方法，理解request.form的工作原理。

💡 核心概念

在Web开发中，表单是用户与服务器交互的桥梁。用户通过表单提交数据，服务器接收并处理这些数据。Flask提供了简洁的API来处理表单数据。

🚀 实战案例：用户登录表单

让我们从一个简单的登录表单开始：

📝 步骤1：创建HTML表单

<!-- templates/login.html -->
<!DOCTYPE html>
<html lang="zh-CN">
<head><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1.0"><title>用户登录</title><style>.form-container {max-width: 400px;margin: 50px auto;padding: 20px;border: 1px solid #ddd;border-radius: 8px;box-shadow: 0 2px 10px rgba(0,0,0,0.1);}.form-group {margin-bottom: 15px;}label {display: block;margin-bottom: 5px;font-weight: bold;}input[type="text"], input[type="password"] {width: 100%;padding: 8px;border: 1px solid #ddd;border-radius: 4px;}button {background-color: #007bff;color: white;padding: 10px 20px;border: none;border-radius: 4px;cursor: pointer;}</style>
</head>
<body><div class="form-container"><h2>🔐 用户登录</h2>
<form method="POST" action="/login"><div class="form-group"><label for="username">用户名：</label><input type="text" id="username" name="username" required></div><div class="form-group"><label for="password">密码：</label><input type="password" id="password" name="password" required></div><button type="submit">🚀 登录</button>
</form></div>
</body>
</html>

🐍 步骤2：Flask路由处理

from flask import Flask, request, render_template, redirect, url_for, flashapp = Flask(__name__)
app.secret_key = 'your-secret-key'  # 用于flash消息@app.route('/login', methods=['GET', 'POST'])
def login():"""处理用户登录"""if request.method == 'POST':# 获取表单数据username = request.form.get("username")password = request.form.get("password")# 简单的验证逻辑（实际项目中应该查询数据库）if username == "admin" and password == "123456":flash("🎉 登录成功！欢迎回来", "success")return redirect(url_for("dashboard"))else:flash("❌ 用户名或密码错误，请重试", "error")return render_template("login.html")@app.route('/dashboard')
def dashboard():"""用户仪表板"""return """<h1>🎯 欢迎来到用户仪表板</h1><p>恭喜你成功实现了Flask表单处理！</p><a href="/login">返回登录页面</a>"""if __name__ == '__main__':app.run(debug=True)

🔍 代码解析

关键知识点：

request.form.get()：安全获取表单数据，避免KeyError
methods=['GET', 'POST']：允许处理GET和POST请求
flash()消息：向用户显示操作反馈
redirect()：页面重定向，提升用户体验

⚡ 运行效果

启动应用后访问 http://127.0.0.1:5000/login：

输入用户名：admin
输入密码：123456
点击登录，将看到成功消息并跳转到仪表板

2. 进阶技巧：使用WTForms构建强大表单

🎯 学习目标

掌握WTForms的高级功能，实现强大的表单验证和错误处理。

💡 为什么选择WTForms？

虽然Flask的request.form可以处理基本表单，但在实际项目中，我们需要：

✅ 数据验证：确保用户输入符合要求
✅ 错误处理：友好的错误提示
✅ CSRF保护：防止跨站请求伪造
✅ 代码复用：表单逻辑与视图分离

🚀 实战案例：用户注册系统

📦 步骤1：安装依赖

pip install flask-wtf

📝 步骤2：定义表单类

from flask_wtf import FlaskForm
from wtforms import StringField, PasswordField, SubmitField, EmailField
from wtforms.validators import DataRequired, Length, Email, EqualTo
from wtforms.widgets import PasswordInputclass RegisterForm(FlaskForm):"""用户注册表单"""username = StringField('用户名', validators=[DataRequired(message='用户名不能为空'),Length(min=3, max=20, message='用户名长度必须在3-20个字符之间')],render_kw={'placeholder': '请输入用户名', 'class': 'form-control'})email = EmailField('邮箱地址',validators=[DataRequired(message='邮箱不能为空'),Email(message='请输入有效的邮箱地址')],render_kw={'placeholder': '请输入邮箱', 'class': 'form-control'})password = PasswordField('密码',validators=[DataRequired(message='密码不能为空'),Length(min=6, message='密码长度至少6位')],render_kw={'placeholder': '请输入密码', 'class': 'form-control'})confirm_password = PasswordField('确认密码',validators=[DataRequired(message='请确认密码'),EqualTo('password', message='两次输入的密码不一致')],render_kw={'placeholder': '请再次输入密码', 'class': 'form-control'})submit = SubmitField('注册账号',render_kw={'class': 'btn btn-primary btn-block'})

🐍 步骤3：Flask路由实现

from flask import Flask, render_template, redirect, url_for, flash, request
from flask_wtf.csrf import CSRFProtectapp = Flask(__name__)
app.secret_key = 'your-super-secret-key'
csrf = CSRFProtect(app)@app.route('/register', methods=['GET', 'POST'])
def register():"""用户注册页面"""form = RegisterForm()if form.validate_on_submit():# 表单验证通过，处理注册逻辑username = form.username.dataemail = form.email.datapassword = form.password.data# 这里应该将用户信息保存到数据库# 为了演示，我们只显示成功消息flash(f'🎉 注册成功！欢迎 {username} 加入我们！', 'success')return redirect(url_for('login'))# 如果有验证错误，表单会自动包含错误信息return render_template('register.html', form=form)@app.route('/login', methods=['GET', 'POST'])
def login():"""用户登录页面"""form = LoginForm()if form.validate_on_submit():username = form.username.datapassword = form.password.data# 验证用户凭据（实际项目中应该查询数据库）if username == "admin" and password == "123456":flash("🎉 登录成功！", "success")return redirect(url_for("dashboard"))else:flash("❌ 用户名或密码错误", "error")return render_template('login.html', form=form)

🎨 步骤4：模板文件

<!-- templates/register.html -->
<!DOCTYPE html>
<html lang="zh-CN">
<head><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1.0"><title>用户注册</title><link href="https://cdn.jsdelivr.net/npm/bootstrap@5.1.3/dist/css/bootstrap.min.css" rel="stylesheet">
</head>
<body><div class="container mt-5"><div class="row justify-content-center"><div class="col-md-6"><div class="card"><div class="card-header"><h3 class="text-center">📝 用户注册</h3></div><div class="card-body"><!-- Flash消息 -->{% with messages = get_flashed_messages(with_categories=true) %}{% if messages %}{% for category, message in messages %}<div class="alert alert-{{ 'danger' if category == 'error' else category }} alert-dismissible fade show">{{ message }}<button type="button" class="btn-close" data-bs-dismiss="alert"></button></div>{% endfor %}{% endif %}{% endwith %}<form method="POST">{{ form.hidden_tag() }}<div class="mb-3">{{ form.username.label(class="form-label") }}{{ form.username() }}{% if form.username.errors %}<div class="text-danger">{% for error in form.username.errors %}<small>{{ error }}</small>{% endfor %}</div>{% endif %}</div><div class="mb-3">{{ form.email.label(class="form-label") }}{{ form.email() }}{% if form.email.errors %}<div class="text-danger">{% for error in form.email.errors %}<small>{{ error }}</small>{% endfor %}</div>{% endif %}</div><div class="mb-3">{{ form.password.label(class="form-label") }}{{ form.password() }}{% if form.password.errors %}<div class="text-danger">{% for error in form.password.errors %}<small>{{ error }}</small>{% endfor %}</div>{% endif %}</div><div class="mb-3">{{ form.confirm_password.label(class="form-label") }}{{ form.confirm_password() }}{% if form.confirm_password.errors %}<div class="text-danger">{% for error in form.confirm_password.errors %}<small>{{ error }}</small>{% endfor %}</div>{% endif %}</div><div class="d-grid">{{ form.submit() }}</div>
</form><div class="text-center mt-3"><p>已有账号？ <a href="{{ url_for('login') }}">立即登录</a></p></div></div></div></div></div></div>
</body>
</html>

🔍 核心特性解析

1. 内置验证器

DataRequired()：必填字段验证
Length()：长度验证
Email()：邮箱格式验证
EqualTo()：字段值相等验证

2. 自定义错误消息

DataRequired(message='用户名不能为空')

3. CSRF保护

{{ form.hidden_tag() }}  # 自动生成CSRF token

4. 样式定制

render_kw={'class': 'form-control'}  # 添加CSS类

3. 安全防护：自定义验证与CSRF保护

🎯 学习目标

掌握自定义验证器的编写，理解CSRF攻击原理和防护措施。

🛡️ 自定义验证器：提升数据安全性

虽然WTForms提供了丰富的内置验证器，但在实际项目中，我们经常需要自定义验证逻辑。

📝 实战案例：用户注册高级验证

from wtforms.validators import ValidationError
import re
from datetime import datetimeclass AdvancedRegisterForm(FlaskForm):"""高级用户注册表单"""username = StringField('用户名', validators=[DataRequired()])email = StringField('邮箱', validators=[DataRequired()])password = PasswordField('密码', validators=[DataRequired()])birth_date = StringField('出生日期', validators=[DataRequired()])def validate_username(self, field):"""自定义用户名验证"""username = field.data# 检查用户名是否包含敏感词forbidden_words = ['admin', 'root', 'system', 'test']if any(word in username.lower() for word in forbidden_words):raise ValidationError('用户名不能包含敏感词汇')# 检查用户名格式（只允许字母、数字、下划线）if not re.match(r'^[a-zA-Z0-9_]+$', username):raise ValidationError('用户名只能包含字母、数字和下划线')def validate_email(self, field):"""自定义邮箱验证"""email = field.data# 基础邮箱格式验证if not re.match(r'^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$', email):raise ValidationError('请输入有效的邮箱地址')# 检查邮箱域名（示例：只允许特定域名）allowed_domains = ['gmail.com', 'qq.com', '163.com', 'outlook.com']domain = email.split('@')[1]if domain not in allowed_domains:raise ValidationError('目前只支持Gmail、QQ、163、Outlook邮箱')def validate_password(self, field):"""自定义密码强度验证"""password = field.data# 密码强度检查if len(password) < 8:raise ValidationError('密码长度至少8位')if not re.search(r'[A-Z]', password):raise ValidationError('密码必须包含至少一个大写字母')if not re.search(r'[a-z]', password):raise ValidationError('密码必须包含至少一个小写字母')if not re.search(r'\d', password):raise ValidationError('密码必须包含至少一个数字')if not re.search(r'[!@#$%^&*(),.?":{}|<>]', password):raise ValidationError('密码必须包含至少一个特殊字符')def validate_birth_date(self, field):"""自定义出生日期验证"""try:birth_date = datetime.strptime(field.data, '%Y-%m-%d')today = datetime.now()age = today.year - birth_date.yearif age < 13:raise ValidationError('注册用户必须年满13岁')elif age > 120:raise ValidationError('请输入有效的出生日期')except ValueError:raise ValidationError('请输入正确的日期格式 (YYYY-MM-DD)')

🔒 CSRF保护：防止跨站请求伪造

什么是CSRF攻击？

CSRF（Cross-Site Request Forgery）是一种网络攻击方式，攻击者诱导用户在已认证的网站上执行非本意的操作。

🛡️ Flask-WTF的CSRF保护机制

from flask_wtf.csrf import CSRFProtect
from flask import Flaskapp = Flask(__name__)
app.secret_key = 'your-secret-key'# 启用CSRF保护
csrf = CSRFProtect(app)# 或者为特定路由禁用CSRF
@csrf.exempt
@app.route('/api/public', methods=['POST'])
def public_api():return "这个API不需要CSRF保护"

📝 模板中的CSRF Token

<!-- 方法1：使用hidden_tag() -->
<form method="POST">{{ form.hidden_tag() }}<!-- 其他表单字段 -->
</form><!-- 方法2：手动添加CSRF token -->
<form method="POST"><input type="hidden" name="csrf_token" value="{{ csrf_token() }}"/><!-- 其他表单字段 -->
</form>

🔧 自定义CSRF配置

from flask_wtf.csrf import CSRFProtect# 自定义CSRF配置
csrf = CSRFProtect(app)# 设置CSRF token过期时间（默认3600秒）
app.config['WTF_CSRF_TIME_LIMIT'] = 1800  # 30分钟# 设置CSRF token长度
app.config['WTF_CSRF_FIELD_NAME'] = 'csrf_token'# 自定义CSRF错误处理
@app.errorhandler(CSRFError)
def handle_csrf_error(e):return render_template('csrf_error.html', reason=e.description), 400

🎨 优雅的错误提示

📱 响应式错误提示组件

<!-- templates/components/error_messages.html -->
{% macro render_field_errors(field) %}{% if field.errors %}<div class="alert alert-danger alert-dismissible fade show mt-2" role="alert"><ul class="mb-0">{% for error in field.errors %}<li><i class="fas fa-exclamation-triangle me-2"></i>{{ error }}</li>{% endfor %}</ul><button type="button" class="btn-close" data-bs-dismiss="alert"></button></div>{% endif %}
{% endmacro %}{% macro render_form_errors(form) %}{% if form.errors %}<div class="alert alert-warning alert-dismissible fade show" role="alert"><h6><i class="fas fa-info-circle me-2"></i>请检查以下问题：</h6><ul class="mb-0">{% for field, errors in form.errors.items() %}{% for error in errors %}<li><strong>{{ form[field].label.text }}：</strong>{{ error }}</li>{% endfor %}
{% endfor %}</ul><button type="button" class="btn-close" data-bs-dismiss="alert"></button></div>{% endif %}
{% endmacro %}

🎯 使用示例

<!-- 在表单中使用 -->
<form method="POST">{{ form.hidden_tag() }}<div class="mb-3">{{ form.username.label(class="form-label") }}{{ form.username(class="form-control") }}{{ render_field_errors(form.username) }}</div><!-- 显示所有表单错误 -->{{ render_form_errors(form) }}<button type="submit" class="btn btn-primary">提交</button>
</form>

4. 状态管理：Session与Cookie的深度解析

🎯 学习目标

深入理解Session和Cookie的工作原理，掌握用户状态管理的最佳实践。

🍪 Cookie vs Session：选择合适的状态管理方案

特性	Cookie	Session
存储位置	客户端浏览器	服务器端
安全性	较低（可被篡改）	较高（服务器控制）
存储大小	有限（4KB）	较大（受服务器限制）
适用场景	用户偏好、记住登录	敏感信息、购物车

🚀 实战案例：完整的用户认证系统

📝 步骤1：Session管理实现

from flask import Flask, session, request, redirect, url_for, render_template, flash
from functools import wraps
import hashlib
from datetime import timedeltaapp = Flask(__name__)
app.secret_key = 'your-super-secret-key'# 设置Session配置
app.config['PERMANENT_SESSION_LIFETIME'] = timedelta(days=7)  # 7天过期# 模拟用户数据库
users_db = {'admin': {'password': '5d41402abc4b2a76b9719d911017c592',  # 'hello'的MD5'email': 'admin@example.com','role': 'admin'},'user1': {'password': '5d41402abc4b2a76b9719d911017c592','email': 'user1@example.com','role': 'user'}
}def hash_password(password):"""密码哈希函数"""return hashlib.md5(password.encode()).hexdigest()def login_required(f):"""登录验证装饰器"""@wraps(f)def decorated_function(*args, **kwargs):if 'user_id' not in session:flash('请先登录', 'error')return redirect(url_for('login'))return f(*args, **kwargs)return decorated_functiondef admin_required(f):"""管理员权限装饰器"""@wraps(f)def decorated_function(*args, **kwargs):if 'user_id' not in session:flash('请先登录', 'error')return redirect(url_for('login'))user_role = session.get('user_role')if user_role != 'admin':flash('需要管理员权限', 'error')return redirect(url_for('dashboard'))return f(*args, **kwargs)return decorated_function@app.route('/login', methods=['GET', 'POST'])
def login():"""用户登录"""if request.method == 'POST':username = request.form.get('username')password = request.form.get('password')remember_me = request.form.get('remember_me')# 验证用户凭据if username in users_db:user = users_db[username]if user['password'] == hash_password(password):# 登录成功，设置Sessionsession['user_id'] = usernamesession['user_email'] = user['email']session['user_role'] = user['role']# 处理"记住我"功能if remember_me:session.permanent = Trueflash(f'🎉 欢迎回来，{username}！', 'success')return redirect(url_for('dashboard'))else:flash('❌ 密码错误', 'error')else:flash('❌ 用户不存在', 'error')return render_template('login.html')@app.route('/logout')
def logout():"""用户登出"""username = session.get('user_id', '未知用户')session.clear()  # 清除所有Session数据flash(f'👋 {username}，您已成功登出', 'info')return redirect(url_for('login'))@app.route('/dashboard')
@login_required
def dashboard():"""用户仪表板"""user_info = {'username': session.get('user_id'),'email': session.get('user_email'),'role': session.get('user_role')}return render_template('dashboard.html', user=user_info)@app.route('/admin')
@admin_required
def admin_panel():"""管理员面板"""return render_template('admin.html', users=users_db)

🍪 步骤2：Cookie高级应用

from flask import make_response, request
from datetime import datetime, timedelta@app.route('/set_preferences', methods=['POST'])
@login_required
def set_preferences():"""设置用户偏好（使用Cookie）"""theme = request.form.get('theme', 'light')language = request.form.get('language', 'zh-CN')timezone = request.form.get('timezone', 'Asia/Shanghai')# 创建响应对象resp = make_response(redirect(url_for('dashboard')))# 设置Cookie（30天过期）resp.set_cookie('user_theme', theme, max_age=30*24*3600)resp.set_cookie('user_language', language, max_age=30*24*3600)resp.set_cookie('user_timezone', timezone, max_age=30*24*3600)# 设置安全Cookie（仅HTTPS传输）resp.set_cookie('secure_pref', 'sensitive_data', secure=True, httponly=True, samesite='Strict')flash('✅ 偏好设置已保存', 'success')return resp@app.route('/get_preferences')
@login_required
def get_preferences():"""获取用户偏好"""preferences = {'theme': request.cookies.get('user_theme', 'light'),'language': request.cookies.get('user_language', 'zh-CN'),'timezone': request.cookies.get('user_timezone', 'Asia/Shanghai'),'last_visit': request.cookies.get('last_visit', '首次访问')}return render_template('preferences.html', prefs=preferences)@app.before_request
def track_visit():"""记录用户访问（使用Cookie）"""if 'user_id' in session:# 更新最后访问时间resp = make_response()resp.set_cookie('last_visit', datetime.now().isoformat())return resp

🔐 Session安全最佳实践

1. 安全的Session配置

# 生产环境配置
app.config.update(SECRET_KEY='your-production-secret-key',  # 使用强密钥SESSION_COOKIE_SECURE=True,              # 仅HTTPS传输SESSION_COOKIE_HTTPONLY=True,            # 防止XSS攻击SESSION_COOKIE_SAMESITE='Lax',           # CSRF保护PERMANENT_SESSION_LIFETIME=timedelta(hours=2)  # 2小时过期
)

2. Session数据清理

@app.route('/clear_session')
def clear_session():"""清理敏感Session数据"""# 只保留必要的Session数据user_id = session.get('user_id')session.clear()session['user_id'] = user_id  # 保留用户IDreturn 'Session已清理'

3. 多设备登录管理

@app.route('/login', methods=['POST'])
def login():# ... 验证逻辑 ...# 检查是否已有活跃Sessionif 'user_id' in session:flash('您已在其他设备登录，是否继续？', 'warning')return redirect(url_for('confirm_login'))# 设置设备标识device_id = request.headers.get('User-Agent', 'unknown')session['device_id'] = hashlib.md5(device_id.encode()).hexdigest()# ... 登录逻辑 ...

🎨 用户界面增强

📱 响应式登录表单

<!-- templates/login.html -->
<!DOCTYPE html>
<html lang="zh-CN">
<head><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1.0"><title>用户登录</title><link href="https://cdn.jsdelivr.net/npm/bootstrap@5.1.3/dist/css/bootstrap.min.css" rel="stylesheet"><link href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.0.0/css/all.min.css" rel="stylesheet">
</head>
<body class="bg-light"><div class="container"><div class="row justify-content-center"><div class="col-md-6 col-lg-4"><div class="card shadow mt-5"><div class="card-header bg-primary text-white text-center"><h4><i class="fas fa-lock me-2"></i>用户登录</h4></div><div class="card-body"><!-- Flash消息 -->{% with messages = get_flashed_messages(with_categories=true) %}{% if messages %}{% for category, message in messages %}<div class="alert alert-{{ 'danger' if category == 'error' else category }} alert-dismissible fade show">{{ message }}<button type="button" class="btn-close" data-bs-dismiss="alert"></button></div>{% endfor %}{% endif %}{% endwith %}<form method="POST"><div class="mb-3"><label for="username" class="form-label"><i class="fas fa-user me-1"></i>用户名</label><input type="text" class="form-control" id="username" name="username" required></div><div class="mb-3"><label for="password" class="form-label"><i class="fas fa-key me-1"></i>密码</label><input type="password" class="form-control" id="password" name="password" required></div><div class="mb-3 form-check"><input type="checkbox" class="form-check-input" id="remember_me" name="remember_me"><label class="form-check-label" for="remember_me">记住我（7天）</label></div><div class="d-grid"><button type="submit" class="btn btn-primary"><i class="fas fa-sign-in-alt me-1"></i>登录</button></div></form><div class="text-center mt-3"><small class="text-muted">演示账号：admin / hello</small></div></div></div></div></div></div>
</body>
</html>

🔍 调试和监控

📊 Session状态监控

@app.route('/session_info')
@login_required
def session_info():"""显示当前Session信息（调试用）"""session_data = {'user_id': session.get('user_id'),'user_role': session.get('user_role'),'session_id': session.get('_id'),'permanent': session.permanent,'expires': session.get('_permanent_session_lifetime')}return f"<pre>{session_data}</pre>"@app.route('/cookie_info')
def cookie_info():"""显示当前Cookie信息"""cookies = dict(request.cookies)return f"<pre>{cookies}</pre>"

5. 实战项目：完整用户认证系统

🎯 项目目标

构建一个功能完整的用户认证系统，包含注册、登录、权限管理、密码重置等核心功能。

🚀 完整项目结构

flask_auth_demo/
├── app.py                 # 主应用文件
├── requirements.txt       # 依赖包
├── config.py            # 配置文件
├── models.py            # 数据模型
├── forms.py             # 表单类
├── templates/           # 模板文件
│   ├── base.html
│   ├── auth/
│   │   ├── login.html
│   │   ├── register.html
│   │   └── reset_password.html
│   └── dashboard.html
├── static/              # 静态文件
│   ├── css/
│   └── js/
└── README.md

📝 核心功能实现

🔐 安全配置

# config.py
import os
from datetime import timedeltaclass Config:SECRET_KEY = os.environ.get('SECRET_KEY') or 'dev-secret-key'SQLALCHEMY_DATABASE_URI = os.environ.get('DATABASE_URL') or 'sqlite:///app.db'SQLALCHEMY_TRACK_MODIFICATIONS = False# Session配置PERMANENT_SESSION_LIFETIME = timedelta(hours=2)SESSION_COOKIE_SECURE = True  # 生产环境SESSION_COOKIE_HTTPONLY = TrueSESSION_COOKIE_SAMESITE = 'Lax'# 邮件配置MAIL_SERVER = 'smtp.gmail.com'MAIL_PORT = 587MAIL_USE_TLS = TrueMAIL_USERNAME = os.environ.get('MAIL_USERNAME')MAIL_PASSWORD = os.environ.get('MAIL_PASSWORD')

👤 用户模型

# models.py
from flask_sqlalchemy import SQLAlchemy
from flask_login import UserMixin
from werkzeug.security import generate_password_hash, check_password_hash
from datetime import datetimedb = SQLAlchemy()class User(UserMixin, db.Model):"""用户模型"""id = db.Column(db.Integer, primary_key=True)username = db.Column(db.String(80), unique=True, nullable=False)email = db.Column(db.String(120), unique=True, nullable=False)password_hash = db.Column(db.String(128))role = db.Column(db.String(20), default='user')is_active = db.Column(db.Boolean, default=True)created_at = db.Column(db.DateTime, default=datetime.utcnow)last_login = db.Column(db.DateTime)def set_password(self, password):"""设置密码"""self.password_hash = generate_password_hash(password)def check_password(self, password):"""验证密码"""return check_password_hash(self.password_hash, password)def __repr__(self):return f'<User {self.username}>'

📋 表单定义

# forms.py
from flask_wtf import FlaskForm
from wtforms import StringField, PasswordField, SubmitField, BooleanField
from wtforms.validators import DataRequired, Length, Email, EqualTo, ValidationError
from models import Userclass LoginForm(FlaskForm):"""登录表单"""username = StringField('用户名', validators=[DataRequired(), Length(min=3, max=20)])password = PasswordField('密码', validators=[DataRequired()])remember_me = BooleanField('记住我')submit = SubmitField('登录')class RegisterForm(FlaskForm):"""注册表单"""username = StringField('用户名', validators=[DataRequired(), Length(min=3, max=20)])email = StringField('邮箱', validators=[DataRequired(), Email()])password = PasswordField('密码', validators=[DataRequired(), Length(min=6)])password2 = PasswordField('确认密码', validators=[DataRequired(), EqualTo('password')])submit = SubmitField('注册')def validate_username(self, username):user = User.query.filter_by(username=username.data).first()if user:raise ValidationError('用户名已存在')def validate_email(self, email):user = User.query.filter_by(email=email.data).first()if user:raise ValidationError('邮箱已被注册')

🎨 现代化界面设计

📱 响应式仪表板

<!-- templates/dashboard.html -->
<!DOCTYPE html>
<html lang="zh-CN">
<head><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1.0"><title>用户仪表板</title><link href="https://cdn.jsdelivr.net/npm/bootstrap@5.1.3/dist/css/bootstrap.min.css" rel="stylesheet"><link href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.0.0/css/all.min.css" rel="stylesheet">
</head>
<body><nav class="navbar navbar-expand-lg navbar-dark bg-primary"><div class="container"><a class="navbar-brand" href="#"><i class="fas fa-shield-alt me-2"></i>安全认证系统</a><div class="navbar-nav ms-auto"><span class="navbar-text me-3"><i class="fas fa-user me-1"></i>{{ current_user.username }}</span><a class="nav-link" href="{{ url_for('logout') }}"><i class="fas fa-sign-out-alt me-1"></i>退出</a></div></div></nav><div class="container mt-4"><div class="row"><div class="col-md-4"><div class="card"><div class="card-header"><h5><i class="fas fa-user-circle me-2"></i>用户信息</h5></div><div class="card-body"><p><strong>用户名：</strong>{{ current_user.username }}</p><p><strong>邮箱：</strong>{{ current_user.email }}</p><p><strong>角色：</strong><span class="badge bg-{{ 'warning' if current_user.role == 'admin' else 'info' }}">{{ '管理员' if current_user.role == 'admin' else '普通用户' }}</span></p><p><strong>注册时间：</strong>{{ current_user.created_at.strftime('%Y-%m-%d') }}</p></div></div></div><div class="col-md-8"><div class="card"><div class="card-header"><h5><i class="fas fa-chart-line me-2"></i>系统统计</h5></div><div class="card-body"><div class="row text-center"><div class="col-md-3"><div class="card bg-primary text-white"><div class="card-body"><h3>{{ total_users }}</h3><p>总用户数</p></div></div></div><div class="col-md-3"><div class="card bg-success text-white"><div class="card-body"><h3>{{ active_users }}</h3><p>活跃用户</p></div></div></div><div class="col-md-3"><div class="card bg-info text-white"><div class="card-body"><h3>{{ today_logins }}</h3><p>今日登录</p></div></div></div><div class="col-md-3"><div class="card bg-warning text-white"><div class="card-body"><h3>{{ admin_count }}</h3><p>管理员</p></div></div></div></div></div></div></div></div></div>
</body>
</html>