Rails表单multiple: true致参数异常，ActiveStorage多文件上传报错排查

嘿，这个问题我之前在做ActiveStorage多文件上传的时候也踩过坑，咱们一步步来拆解原因和解决办法：

为什么会出现这个问题？ #

核心问题出在表单提交的参数命名格式以及强参数的匹配上：

• 没加multiple: true时，Rails的file_field会自动生成带[]的参数名（比如article[files][]），浏览器会把上传的文件包装成数组提交，这和你强参数里预期的数组结构完全匹配，所以能正常工作。
• 但加上multiple: true后，有时候form_with绑定model的情况下，helper没有自动给参数名加上[]后缀，导致浏览器把选中的文件（哪怕选了多个）作为单个值提交，而不是数组。这时候你的强参数因为配置的是允许files: []（数组格式），就会把单个值的files判定为不允许的参数，从而抛出"unpermitted param 'files'"错误。

简单说就是：浏览器提交的参数结构和你强参数预期的结构不匹配了！

怎么修复？ #

1. 修正表单的文件输入参数名 #

修改你的file_field代码，手动指定参数名带[]，确保浏览器提交数组格式的参数：

<%= f.file_field :files, multiple: true, name: 'article[files][]' %>

这样生成的HTML输入框会带正确的数组命名：

<input type="file" name="article[files][]" multiple="multiple">

之后浏览器就会把所有选中的文件包装成数组提交，参数结构就会回到正常的"article"=>{"files"=>[#<ActionDispatch::Http::UploadedFile...>, ...]}。

2. 确认强参数配置正确 #

在ArticlesController里，确保强参数明确允许files作为数组存在：

def article_params
  params.require(:article).permit(files: [])
end

这个配置告诉Rails：files是数组类型的参数，允许被提交。如果你的强参数之前写的是permit(:files)（允许单个值），那也会导致数组格式的参数被拒绝，所以一定要改成数组格式的配置。

3. 验证ActiveStorage关联设置 #

最后确认你的Article模型里的ActiveStorage关联是多文件类型的：

class Article < ApplicationRecord
  has_many_attached :files
end

如果是has_one_attached :file的话，即使表单提交数组也会出问题，不过从你的代码来看应该是多文件关联，确认一下更稳妥。

做完这几步，再测试多文件上传，应该就能正常接收参数，不会再出现unpermitted的错误啦！

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