密码安全加密：使用 Werkzeug 进行加盐哈希存储

📂 所属阶段：第三阶段 — 用户系统（安全篇）
🔗 相关章节：Flask-Login 实战 · 数据验证

1. 绝对禁止的做法

安全无小事，密码存储更是 Web 应用的「第一道生死线」——以下三种错误一旦发生，轻则泄露用户数据、重则面临合规处罚：

# ❌ 灾难级：明文存储（等于把钥匙直接放在小偷面前）
user.password = request.form["password"]

# ❌ 无效级：简单哈希（MD5/SHA1 早已被彩虹表库「攻破」成百上千次）
import hashlib
hashed = hashlib.md5(password.encode()).hexdigest()

# ❌ 自欺欺人级：固定盐值（所有用户共用同一个盐，还是一破全破）
salt = "myapp_fixed_salt_12345"
hashed = hashlib.sha256((password + salt).encode()).hexdigest()

安全核心原则：慢哈希算法 + 每个用户独立随机盐 + 专业安全库（比如 Werkzeug）

2. Werkzeug 哈希工具（开箱即用）

Werkzeug 是 Flask 的底层依赖库，自带一套经过 OWASP 验证的密码安全工具，完全不需要我们自己造轮子：

2.1 两个核心函数就够了

Werkzeug 把复杂的加盐、迭代、验证逻辑全封装在两个函数里：

from werkzeug.security import generate_password_hash, check_password_hash

# 1️⃣ 注册时生成带随机盐的安全哈希
# 默认格式：pbkdf2:sha256:600000$随机盐$最终哈希（三段式，全存数据库就行）
password_hash = generate_password_hash("MyStrongPassword_2024!")

# 2️⃣ 登录时验证密码（自动解析哈希格式、迭代次数、盐值）
is_valid = check_password_hash(password_hash, "MyStrongPassword_2024!")
print(is_valid)  # ✅ True
print(check_password_hash(password_hash, "wrongpass"))  # ❌ False

2.2 直接对接数据库的用法

下面是最贴合 Flask/SQLAlchemy 项目的场景代码：

# 注册接口（节选）
from app.models import User
from app.extensions import db

@app.route("/register", methods=["POST"])
def register():
    email = request.form["email"]
    password = request.form["password"]
    # 先检查邮箱是否已存在，再生成哈希
    if User.query.filter_by(email=email).first():
        return "邮箱已注册", 400
    # ✅ 直接调用 Werkzeug 工具
    new_user = User(
        email=email,
        password_hash=generate_password_hash(password)
    )
    db.session.add(new_user)
    db.session.commit()
    return "注册成功", 201

# 登录接口（节选）
@app.route("/login", methods=["POST"])
def login():
    email = request.form["email"]
    password = request.form["password"]
    user = User.query.filter_by(email=email).first()
    # ✅ 统一的错误提示（防止枚举用户）
    if not user or not check_password_hash(user.password_hash, password):
        return "邮箱或密码错误", 401
    # 登录成功后的逻辑（比如设置 Flask-Login 的 session）
    return "登录成功", 200

2.3 可选的更强哈希算法

如果对安全要求极高（比如金融、医疗类应用），可以替换 Werkzeug 的默认算法：

# 1️⃣ 默认算法 pbkdf2:sha256（60万次迭代，平衡了安全与性能）
generate_password_hash("password", method="pbkdf2:sha256")

# 2️⃣ 更安全的 scrypt（内存密集型，GPU/ASIC 破解难度大）
generate_password_hash("password", method="scrypt")

# 3️⃣ 经典的 bcrypt（需要单独安装依赖 pip install bcrypt）
generate_password_hash("password", method="bcrypt")

3. 更优雅的封装：完整的 User 模型

把密码的哈希和验证逻辑封装到 User 模型内部，可以避免业务层写错，代码更整洁：

# app/models/user.py
from datetime import datetime
from werkzeug.security import generate_password_hash, check_password_hash
from flask_login import UserMixin  # 如果用 Flask-Login
from app.extensions import db

class User(UserMixin, db.Model):
    __tablename__ = "users"

    id = db.Column(db.Integer, primary_key=True)
    username = db.Column(db.String(50), unique=True, index=True)
    email = db.Column(db.String(120), unique=True, nullable=False, index=True)
    password_hash = db.Column(db.String(256), nullable=False)  # 留够空间存三段式哈希
    created_at = db.Column(db.DateTime, default=datetime.utcnow)

    # ⚠️ 禁止直接读取密码（抛出错误提醒开发者）
    @property
    def password(self):
        raise AttributeError("密码是私有属性，不可直接读取！")

    # ✅ 设置密码时自动哈希（业务层只需要 user.password = "xxx"）
    @password.setter
    def password(self, plaintext):
        self.password_hash = generate_password_hash(plaintext)

    # ✅ 验证密码的模型方法（业务层只需要 user.check_password("xxx")）
    def check_password(self, plaintext):
        return check_password_hash(self.password_hash, plaintext)

    def __repr__(self):
        return f"<User {self.email}>"

封装后，业务层的代码会更简洁：

# 注册时（直接用属性赋值）
new_user = User(email="test@example.com", password="MyStrongPassword_2024!")

# 登录时（直接用模型方法）
if user and user.check_password(request.form["password"]):
    # 登录成功

4. 安全最佳实践清单

只靠 Werkzeug 不够，还需要配合以下安全细节：

✅ 必须做到的

  1. 始终使用专业安全库（Werkzeug、bcrypt、passlib 等）
  2. 完全禁止明文/可逆加密存储密码
  3. 密码、密码哈希永远不要出现在日志、错误信息中
  4. 登录验证失败时，统一返回「邮箱或密码错误」（防止攻击者枚举用户）
  5. 生产环境必须全程 HTTPS 传输（防止中间人窃取密码）
  6. 数据库字段长度至少留 256 字节（防止三段式哈希被截断）

❌ 绝对避免的

  1. 自己实现哈希算法、盐值生成逻辑
  2. 用 MD5、SHA1、SHA256 做密码哈希（这些都是「快哈希」，专门用来加速破解的）
  3. 使用固定盐值、或者从用户名/邮箱中提取盐值
  4. 在代码中硬编码盐值或加密密钥
  5. 密码长度限制过短（至少 8 位，建议配合字符复杂度要求）

5. 一分钟总结

安全密码存储的核心，其实就是这「两步走」：

from werkzeug.security import generate_password_hash, check_password_hash

# 📝 注册/修改密码时：生成带随机盐的慢哈希
password_hash = generate_password_hash("your_plain_password")

# 🔑 登录时：自动解析哈希验证
if check_password_hash(user.password_hash, "your_input_password"):
    print("验证成功！")

💡 最后提醒：密码哈希只是第一道防线，还要配合「HTTPS传输」「验证码防暴力破解」「密码强度验证」「密码过期提醒」等措施，才能构建完整的用户系统安全体系。

🔗 扩展阅读