Rails 6.1.3是否仍需手动在表单中添加authenticity_token?
Rails 6.1.3 中authenticity_token的配置规则
核心结论:绝大多数常规开发场景下,你完全不需要手动添加
<input type="hidden" name="authenticity_token" value="<%= form_authenticity_token %>">这行代码。
默认场景下无需手动配置的原因
Rails 6.1.3 初始化的新项目,默认会在ApplicationController中开启CSRF防护配置protect_from_forgery with: :exception,框架会自动完成两类token注入工作,全程不需要开发者手动介入:
- 所有通过Rails内置表单辅助方法(
form_with、form_tag等)生成的服务端渲染表单,会自动在表单DOM末尾携带匹配当前会话的合法authenticity_token隐藏字段 - 所有经过Rails视图管线渲染的页面,会自动在
<head>标签内注入两个全局元标签:<meta name="csrf-param" content="authenticity_token">:标记CSRF校验对应的表单参数名<meta name="csrf-token" content="当前会话的有效token值">:存储全局通用的token值
主流前端工具链(Rails UJS、jQuery、Axios)会自动读取这两个元标签的内容,为所有非GET类型的异步请求自动携带CSRF校验参数,不需要在JS代码中手动拼接token。
仅以下场景需要手动处理token
只有当开发流程绕过了Rails的内置渲染管线时,才需要手动嵌入token逻辑:
- 完全手写原生HTML表单,没有借助任何Rails表单辅助方法生成
<form>标签:此时框架不会自动注入隐藏字段,你可以直接在表单内部手写老课件里的隐藏input,或者改用Rails内置表单帮助方法生成表单 public目录下的纯静态HTML页面需要向Rails后端提交表单:这类静态页面不会经过Rails视图渲染流程,无法自动注入token,需要手动嵌入有效token- 在脱离页面全局上下文的场景发起请求(比如独立Web Worker、离线运行的H5页面):这类场景读取不到页面上的全局CSRF元标签,需要手动调用视图层的
form_authenticity_token方法获取有效token,拼接到请求参数或请求头中
补充说明:你在Rails 5.x课件里看到的手动嵌token的写法,本质是当年为了兼容无辅助方法的原生HTML表单做的操作,这类写法在Rails 6.1.3的常规开发流程里已经被自动化机制完全覆盖,根本没必要照搬老课件的操作。相关逻辑的权威规则直接查Rails 6.1官方指南里跨站请求伪造防护章节的内容就行,规则写得非常明确。
内容的提问来源于stack exchange,提问作者ffouquet42
相关产品推荐
相关产品推荐

