HttpOnly是唯一能阻止document.cookie读写的硬性开关,必须由后端在Set-Cookie中设置;搭配Secure和SameSite可构建三层防护,但需后端校验拦截非法写入与伪造请求。

不能真正“禁止修改 Cookie”,但可以做到让前端脚本读不到、改不了关键 Cookie,同时后端拒绝非法写入请求——这是实际可行的防护边界。
HttpOnly 是唯一能阻止 document.cookie 读写的硬性开关
浏览器层面只认 HttpOnly 属性。只要服务端在 Set-Cookie 响应头里带上它,前端执行 document.cookie 就完全看不到这条 Cookie,更别说赋值修改了。
常见错误是以为在 JS 里写 document.cookie = "sessionid=xxx; HttpOnly" 能生效,其实浏览器直接忽略整条语句。
- 必须由后端设置:用
c.SetCookie()传入的*http.Cookie实例中,显式设HttpOnly: true - 搭配
Secure: true(仅 HTTPS)和SameSite: http.SameSiteLaxMode防跨站携带 - 验证是否生效:DevTools → Application → Cookies → 看对应条目右侧 “HttpOnly” 列是否打钩
后端拒绝非法 Cookie 写入请求
前端无法直接写 HttpOnly Cookie,但可能通过伪造请求体、调用你暴露的 /api/set-cookie 接口来尝试注入。这时候得靠后端校验拦截。
使用 Cookiecutter CLI 和 Jinja2 模板生成项目脚手架。支持自定义模板注册表、通过 Python 脚本的生成后钩子,以及与 GitHub 模板仓库 API 的集成。
典型做法是限制可写 Cookie 的名称白名单:
- 只允许前端写
theme、lang、sidebar_collapsed这类非敏感字段 - 对所有写 Cookie 的接口,检查
c.Request.Header.Get("Origin")是否在可信域名列表内 - 若请求来自用户提交的 HTML 沙箱环境,网关层应提前过滤含
document.cookie=或cookie.*=的 JS 片段(如 OpenResty Lua 扫描)
JWT 或 Session 中间件要主动忽略客户端传来的伪造 Cookie
攻击者可能在请求头或 query 中塞入伪造的 sessionid=xxx 或 token=yyy,试图绕过认证。这时候中间件不能无脑信任。
正确姿势是:
- JWT 中间件必须用
middleware.JWTWithConfig显式指定TokenLookup,比如"cookie:jwt_token",避免被其他同名 Cookie 干扰 - Session 中间件初始化时,确保
session.Middleware()配置了正确的密钥和存储后端,且Store不接受未签名的 session ID - 在权限中间件里,从
c.Get("user")取出身份后,立刻校验该用户是否存在、是否被禁用,而不是直接放行
真正难防的是服务端逻辑漏洞:比如把用户传来的 cookie_name 参数直接拼进 SetCookie() 调用,或没校验 Cookie 值格式就存进数据库。这类问题不会出现在配置里,得靠代码审计和参数白名单守住最后一道门。

















