Rails6升级后Paperclip+S3直传场景@attachment.save保存失败问题

• 优先输出模型错误信息定位根因：在@attachment.save执行后直接打印@attachment.errors.full_messages，确认具体错误类型。Rails 5+版本默认开启belongs_to关联必填校验，如果你的Attachment模型关联了其他父模型且上传时未传入对应关联ID，会直接触发验证失败，这是跨大版本升级最常见的校验不通过原因。
• 核查参数白名单配置：Rails 6对强参数的过滤规则更严格，确认控制器中附件的参数白名单包含Paperclip所需的全部字段（[attachment]_file_name、[attachment]_file_size、[attachment]_content_type、[attachment]_updated_at）以及s3_direct_upload依赖的自定义字段（如[attachment]_direct_upload_url），参数被过滤会触发Paperclip文件存在性校验失败。
• 调整回调触发规则适配Rails新版本：Rails 6对Active Record事务和属性变更检测逻辑做了优化，如果你的S3文件迁移逻辑绑定在after_save回调上，建议改为after_commit :move_to_permanent_storage, on: :create，避免事务未提交时触发回调导致的状态异常，同时确认Paperclip的文件属性变更可以被Active Record正常识别。
• 验证Paperclip与依赖库的适配性：原始thoughtbot/paperclip已停止维护，最高仅支持到Rails 5.2，Rails 6环境必须使用kt-paperclip兼容分支。如果同时升级了aws-sdk到v3，需要调整Paperclip的S3配置：旧版s3_credentials配置项在aws-sdk v3下需要拆分为access_key_id、secret_access_key、region单独配置，或通过aws配置块传递客户端实例，配置不匹配会导致Paperclip校验文件存活性失败，触发save回滚。
• 排查隐藏的事务回滚原因：开启Rails debug日志，查看@attachment.save执行过程中是否有事务回滚日志，确认是否存在before_save、before_create回调抛出异常或返回false。Rails 5+版本中回调抛出ActiveRecord::Rollback之外的异常会直接触发事务全量回滚，和Rails 4.2的异常处理逻辑存在差异。
• 临时跳过验证缩小排查范围：调用@attachment.save(validate: false)临时关闭校验，如果可以保存成功说明问题出在验证环节，如果仍保存失败则需要检查数据库层约束（如新增的非空约束、唯一索引）是否阻止了数据写入。

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