Rails环境Cloudinary控制台可上传 表单报错缺Active Storage配置

问题概述 #

• 基于Ruby on Rails搭建博客，开发环境计划通过Cloudinary处理图片上传
• 已完成Active Storage与Cloudinary的基础配置，但表单提交创建文章时触发错误：

Missing configuration for the cloudinary Active Storage service. Configurations available for the test and local services.

• Rails控制台（rails c）内可正常上传图片，仅Web表单提交场景报错

相关控制器代码片段：

# line 15
14  def create
15    @article = Article.new(article_params)
16    if @article.save
17      redirect_to @article
18    else

错误原因 #

1. 开发环境未绑定Cloudinary服务：config/environments/development.rb中未将Active Storage服务指定为:cloudinary，导致Web进程默认使用local服务
2. 环境变量未被Web进程加载：Cloudinary的凭证配置存于环境变量，但Rails服务器启动时未读取到这些变量
3. storage.yml配置不完整：Cloudinary的服务定义缺失或参数错误

解决方案 #

1. 修正开发环境Active Storage服务配置 #

编辑config/environments/development.rb，添加或修改以下配置：

Rails.application.configure do
  # 其他配置项...
  config.active_storage.service = :cloudinary
end

2. 完善config/storage.yml的Cloudinary配置 #

确保文件中包含完整的Cloudinary服务定义：

cloudinary:
  service: Cloudinary
  cloud_name: <%= ENV['CLOUDINARY_CLOUD_NAME'] %>
  api_key: <%= ENV['CLOUDINARY_API_KEY'] %>
  api_secret: <%= ENV['CLOUDINARY_API_SECRET'] %>

3. 验证环境变量加载 #

• 确认项目根目录的.env文件（或使用的环境变量管理工具）包含正确的Cloudinary凭证：

CLOUDINARY_CLOUD_NAME=你的云名称
CLOUDINARY_API_KEY=你的API密钥
CLOUDINARY_API_SECRET=你的API密钥

• 重启Rails开发服务器（rails s），确保Web进程读取到最新的环境变量

4. 检查参数允许规则 #

确认控制器的article_params方法允许图片字段（例如:image）：

private
def article_params
  params.require(:article).permit(:title, :content, :image) # 需包含你的图片字段名
end

5. 测试验证 #

完成以上配置后，重启服务器并重新提交表单，验证图片上传功能是否正常。

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