萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> 程式語言綜合

Python Bottle 框架 Cookie 跨路徑存取:Path 屬性設定詳解

問題現象

Bottle 預設 Cookie path 為當前路由路徑。登入路由 /login 設定 Cookie 後,訪問 /admin 時無法讀取,因為 Cookie 僅在 /login 路徑下發送。

根本原因

Bottle response.set_cookie() 簽名:


set_cookie(name, value, secret=None, **options)
# options 包含: max_age, expires, domain, path, secure, httponly, samesite

預設 path 為請求路徑 (request.path),導致跨路徑不可用。

解決方案:顯式設定 path=/


from bottle import route, request, response

@route('/login', method='POST')
def login():
    username = request.forms.get('username')
    password = request.forms.get('password')
    
    if check_credentials(username, password):
        # 關鍵:path='/' 使全站可訪問
        response.set_cookie('account', username, secret='super-secret', path='/', httponly=True)
        return "登入成功"
    else:
        return "登入失敗"

@route('/admin')
def admin():
    # 現在可以讀取到
    username = request.get_cookie('account', secret='super-secret')
    if username:
        return f"歡迎 {username}"
    else:
        redirect('/login')

替代寫法:直接操作 response.COOKIES


@route('/login', method='POST')
def login():
    user = request.forms.get('user')
    if check_user(user):
        response.COOKIES['account'] = user
        response.COOKIES['account']['path'] = '/'
        response.COOKIES['account']['httponly'] = True
        response.COOKIES['account']['max-age'] = 3600
    else:
        return "失敗"

Cookie 屬性完整說明

屬性用途推薦值
pathCookie 發送路徑前綴'/' (全站) 或具體路徑 '/admin'
domain允許讀取的域名'.example.com' (含子域名) 或不設 (當前域名)
max_age存活秒數3600 (1小時)、86400 (1天)
expires過期時間 (GMT)較 max_age 精確,但需計算
secure僅 HTTPS 傳輸True (生產環境必須)
httponly禁止 JS 讀取True (防 XSS)
samesite跨站請求攜帶策略'Lax' (平衡)、'Strict'、'None' (需 Secure)

調試技巧


@route('/debug/cookies')
def debug_cookies():
    return {
        'request_cookies': dict(request.cookies),
        'response_cookies': {k: dict(v) for k, v in response.COOKIES.items()},
        'request_path': request.path,
        'headers': dict(request.headers)
    }

安全建議

  • 敏感 Cookie 必須設定 secret 簽名防篡改 (Bottle 內建)。
  • 生產環境強制 secure=True, httponly=True, samesite='Lax'。
  • 定期輪換 secret,登出時 response.delete_cookie('name', path='/')。
  • 避免在 Cookie 存放敏感資料 (權限、角色),改用伺服器端 Session + Cookie 存 Session ID。
copyright © 萬盛學電腦網 all rights reserved