Keycloak登录接口设置Cookie后后端无法读取问题求助

1. 修正代码变量名错误 #

你的读取Cookie接口里，参数定义为req:Request，但代码中却使用request.cookies，变量名不匹配是直接导致读取失败的原因之一。修正后的代码：

@app.get("/something")
def get_cookie(req: Request):
     access_cookie = req.cookies.get("session_id")
     # 可添加返回或打印语句用于调试
     return {"session_id": access_cookie}

2. 检查Cookie跨域与SameSite配置 #

如果前后端处于不同域名（跨域场景），需补充以下配置：

• 后端CORS设置：确保FastAPI的CORS中间件开启allow_credentials=True，并允许对应前端域名：

  from fastapi.middleware.cors import CORSMiddleware
  
  app.add_middleware(
      CORSMiddleware,
      allow_origins=["你的前端域名，例如http://localhost:3000"],
      allow_credentials=True,
      allow_methods=["*"],
      allow_headers=["*"],
  )
  

• Cookie属性补充：跨域场景下需设置SameSite=None，HTTPS环境搭配secure=True（本地HTTP环境可设为secure=False，生产环境建议用HTTPS），同时可设置有效期避免会话结束后Cookie失效：

  response.set_cookie(
      key="session_id",
      value=access_token,
      httponly=True,
      path="/",
      same_site="none",
      secure=True,  # 生产HTTPS环境使用，本地HTTP改为False
      max_age=86400  # 设置24小时有效期，按需调整
  )
  

• 前端请求配置：发送请求时需携带凭证，比如Axios添加withCredentials: true，Fetch添加credentials: 'include'。

3. 验证Cookie路径与有效性 #

• 确认/something请求路径在Cookie的path="/"覆盖范围内，子路径需检查是否匹配。
• 打开浏览器开发者工具的「Application -> Cookies」，查看session_id的Domain、Path、Expires/Max-Age等参数是否正确，排查是否存在过期或路径不匹配的情况。

4. 协议一致性检查 #

确保前后端协议一致：后端用HTTPS则前端也需用HTTPS，反之亦然，否则浏览器会拒绝发送Cookie。

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