如何从外部应用向采用Active Storage本地存储的Rails REST API上传文件？

嘿，我正好做过类似的需求，给你详细说下怎么通过POST请求直接给Rails Active Storage传文件，完全绕开HTML表单的那种～

Rails的Active Storage原生支持接收multipart/form-data格式的文件上传，这和HTML表单提交的底层逻辑一致，但我们可以手动构造这种格式的POST请求，不管是iOS、Go还是其他客户端都能实现。

• Content-Type: 必须设为multipart/form-data，不过大部分HTTP客户端（比如iOS的URLSession、Go的net/http）会自动帮你生成带正确boundary的完整头（比如multipart/form-data; boundary=----WebKitFormBoundaryXxXxX），所以不用手动写死boundary，交给客户端处理更稳妥。
• Authorization: 如果你的API需要认证（比如JWT、Devise Token Auth），记得加上这个头，格式比如Authorization: Bearer <你的认证令牌>。
• Accept: 可选但推荐设置为application/json，告诉服务器你希望返回JSON格式的响应，方便客户端解析。

你需要把文件作为表单字段的一部分发送，字段名必须和Rails后端的参数规则对应。举个例子：
假设你要给Post模型上传封面图，后端允许的参数是post[cover_image]，那请求体里的表单字段名就得是这个。

用curl命令模拟的话（直观展示请求结构）：

curl -X POST \
  https://your-rails-api-domain.com/posts \
  -H 'Authorization: Bearer your-auth-token' \
  -H 'Accept: application/json' \
  -F 'post[title]=我的新帖子' \
  -F 'post[cover_image]=@/Users/you/Desktop/photo.jpg'

这里的-F参数就是在构造multipart/form-data的字段，@符号表示后面是本地文件的路径，curl会自动把文件内容封装到请求体里。

先确保你的模型已经挂载了Active Storage：

# app/models/post.rb
class Post < ApplicationRecord
  has_one_attached :cover_image # 对应前端的cover_image字段
end

然后控制器里要允许这个文件参数：

# app/controllers/posts_controller.rb
private
def post_params
  params.require(:post).permit(:title, :cover_image) # 必须把cover_image加入允许列表
end

这样后端就能正确接收文件，并保存到你配置的本地存储路径里了。

• iOS: 用URLSession创建URLRequest，然后通过MultipartFormData类添加字段：把文件数据作为FormDataPart，设置name为post[cover_image]，再把这个form data作为请求体发送。
• Go: 用mime/multipart包创建一个表单，调用CreateFormFile方法添加文件字段，字段名设为post[cover_image]，然后通过http.Post或者http.NewRequest发送请求。

• 别直接把文件二进制数据作为raw请求体发送，Active Storage默认只处理multipart/form-data格式的文件参数。
• 字段名必须和后端permit的参数完全一致，大小写、下划线都不能错，比如后端是cover_image就别写成coverImage。
• 如果遇到400错误，先检查请求头的Content-Type是否正确，或者参数是否符合后端的强校验规则（比如是否缺少post这个顶级参数）。

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