Rails 8迁移后ActionMailer结合SolidQueue发送邮件重复问题

1. 检查 send_later 触发逻辑 #

• 确认代码里有没有重复绑定回调/事件：Rails 8 调整了回调触发机制，比如after_save、after_create这类回调在关联操作时的触发次数可能和 Rails 6 不一样。去看调用send_test的上下文，排查是否存在重复注册的回调。
• 排查是否有双重渲染/重定向：如果控制器里调用邮件发送后，同时执行了render和redirect_to，没正确终止请求，会导致逻辑重复执行两次。

2. 验证异步任务队列配置 #

• 检查队列适配器（比如 Sidekiq、Delayed Job）的并发设置：要是队列并发数太高，且任务没设唯一标识，容易导致重复执行。就算拦截了入队，队列里已有的重复任务还是会触发。
• 确认ActionMailer::DeliveryJob的重试机制：Rails 8 可能改了异步邮件的重试策略，去config/environments/production.rb里看config.action_mailer.delivery_job配置，是不是意外开了不必要的重试。

3. 排查 send_test 方法实现 #

• 检查方法内部有没有递归调用或重复触发异步任务：比如方法里又调用了一次send_later，造成循环入队。
• 验证方法是否被** monkey patch**：升级过程中，第三方 gem 或自定义初始化代码可能修改了ActionMailer的send_later或send_test方法，导致重复执行。

4. 检查 Rails 8 路由/请求处理变更 #

• 排查是否有重复路由匹配：Rails 8 对路由优先级的处理和 Rails 6 不同，同一个请求可能被多个路由规则匹配，导致控制器动作执行两次。
• 验证服务器（比如 Puma）配置：如果 Puma 的workers和threads配置不合理，会导致请求被重复处理。看config/puma.rb里的workers数量，是不是开发环境意外开了多 worker。

5. 调试堆栈一致的问题 #

• 既然两次调用堆栈完全一样，说明是同一触发源导致的重复。可以在send_test开头加日志，记录当前请求的request_id（控制器触发场景）或job_id（任务触发场景），确认是不是同一个请求/任务触发了两次调用。
• 用ActiveSupport::Notifications监听action_mailer.deliver事件，统计触发次数，定位问题出在邮件发送阶段还是任务入队阶段。

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