Day 19 · JWT 用户认证

Week 3 · Day 19 / 56 · 返回大纲

一、密码哈希

uv add "passlib[bcrypt]" python-jose

from passlib.context import CryptContext

pwd_context = CryptContext(schemes=["bcrypt"])

# 注册时哈希
def hash_password(password: str) -> str:
    return pwd_context.hash(password)

# 登录时验证
def verify_password(plain: str, hashed: str) -> bool:
    return pwd_context.verify(plain, hashed)

# 永远不要存明文密码!
# hash_password("123456") → "$2b$12$..."

二、JWT Token

from jose import jwt
from datetime import datetime, timedelta

SECRET_KEY = "your-secret-key-keep-it-safe"
ALGORITHM = "HS256"

def create_token(data: dict) -> str:
    to_encode = data.copy()
    to_encode["exp"] = datetime.utcnow() + timedelta(hours=24)
    return jwt.encode(to_encode, SECRET_KEY, algorithm=ALGORITHM)

def verify_token(token: str) -> dict:
    return jwt.decode(token, SECRET_KEY, algorithms=[ALGORITHM])

三、登录和注册

from fastapi import Depends, HTTPException
from fastapi.security import OAuth2PasswordBearer

oauth2_scheme = OAuth2PasswordBearer(tokenUrl="login")

@app.post("/register")
def register(user: UserCreate):
    hashed = hash_password(user.password)
    db_user = User(name=user.name, email=user.email, hashed_password=hashed)
    db.add(db_user)
    db.commit()
    return {"message": "注册成功"}

@app.post("/login")
def login(email: str, password: str):
    user = db.query(User).filter(User.email == email).first()
    if not user or not verify_password(password, user.hashed_password):
        raise HTTPException(status_code=401, detail="邮箱或密码错误")
    token = create_token({"sub": user.email})
    return {"access_token": token, "token_type": "bearer"}

# 依赖注入获取当前用户
async def get_current_user(token: str = Depends(oauth2_scheme)):
    payload = verify_token(token)
    email = payload.get("sub")
    user = db.query(User).filter(User.email == email).first()
    if not user:
        raise HTTPException(status_code=401)
    return user

@app.get("/me")
def read_me(current_user: User = Depends(get_current_user)):
    return current_user

动手练习

练习 1:注册接口
实现 POST /register
@app.post("/register")
def register(user: UserCreate):
    hashed = hash_password(user.password)
    # 存数据库
    return {"message": "注册成功"}
查看答案
参考答案
# 密码必须哈希存储
练习 2:登录接口
实现 POST /login 返回 token
@app.post("/login")
def login(email: str, password: str):
    # 验证密码
    token = create_token({"sub": email})
    return {"access_token": token}
查看答案
参考答案
# 401 错误表示未认证
练习 3:保护路由
用 Depends 保护 /me 接口
@app.get("/me")
def me(current_user = Depends(get_current_user)):
    return current_user
查看答案
参考答案
# 没带 token 自动返回 401

打卡验收

理解为什么要哈希密码
会用 passlib 做密码哈希
理解 JWT token 的结构
会签发和验证 token
会用依赖注入保护路由
完成 3 个动手练习
能实现注册和登录接口
理解 OAuth2 密码模式
打卡方式: 全部勾选后,告诉我 "Day 19 打卡",并贴出你的代码。