RSpec请求测试中Turbo Stream广播断言失败问题排查

上下文 #

涉及的模型为新闻稿（press release）及其关联的多个新闻稿图片模型，每个新闻稿图片模型关联一个附件。
控制器操作接收文件附件并关联至新闻稿模型后，会广播更新以指定目标框架：

image_model.broadcast_replace_to(image_model.press_release, target: "slot_#{image_model.position}")

使用image_model.press_release作为*streamable参数传入，是因为视图通过turbo_stream_from(@press_release)启动Turbo流，需确保目标流正确。

问题详情 #

编写的RSpec请求测试断言始终无法匹配：

expect do
  post press_release_images_path(press_release), params: params,
                                                 headers: { 'Content-Type' => 'multipart/form-data' }
end.to broadcast_to(press_release).from_channel(Turbo::StreamsChannel)

测试执行后失败，提示该频道未收到任何广播，但测试日志中显示了匹配的流名称：

断言失败信息：
expected to broadcast exactly 1 messages to turbo:streams:Z2lkOi8vcHJlc3MtcmVsZWFzZS1nZW5lcmF0b3IvUHJlc3NSZWxlYXNlLzE5NDM, but broadcast 0

控制器操作日志：
Rendered press_releases/images/_display.html.erb (Duration: 15.2ms | Allocations: 9700) [ActionCable] Broadcasting to Z2lkOi8vcHJlc3MtcmVsZWFzZS1nZW5lcmF0b3IvUHJlc3NSZWxlYXNlLzE5NDM: "<turbo-stream action="update"..."

第二次广播也存在同样问题：流名称在错误信息和日志中均一致，但无法通过断言匹配。希望能按当前思路解决问题，也接受测试该行为的替代方案。

1. 确认Turbo测试助手已加载 #

在spec/rails_helper.rb或spec/spec_helper.rb中确保添加了Turbo的测试依赖：

require "turbo/testing/rspec"

若未添加，补全后重新运行测试。

2. 简化断言验证基础匹配 #

先去掉from_channel约束，验证基础的broadcast_to断言是否生效：

expect do
  post press_release_images_path(press_release), params: params,
                                                 headers: { 'Content-Type' => 'multipart/form-data' }
end.to broadcast_to(press_release)

如果该断言通过，再逐步添加频道约束，或者检查Turbo::StreamsChannel是否为实际使用的广播频道。

3. 核对模型全局ID（gid） #

Turbo的broadcast_to会将模型转换为全局ID作为流名称，在测试中打印模型的gid，与日志中的流名称对比：

# 在测试中输出gid，对比日志中的流名称（注意前缀`turbo:streams:`）
puts press_release.to_global_id.to_s

若存在差异，需确认测试中的press_release实例与控制器中操作的实例是否一致，或检查模型全局ID的生成逻辑。

4. 适配两次广播的断言逻辑 #

因为控制器会发送两次广播，调整断言以匹配次数：

expect do
  post press_release_images_path(press_release), params: params,
                                                 headers: { 'Content-Type' => 'multipart/form-data' }
end.to broadcast_to(press_release).exactly(2).times.from_channel(Turbo::StreamsChannel)

也可以精准验证每次广播的动作：

expect do
  post press_release_images_path(press_release), params: params,
                                                 headers: { 'Content-Type' => 'multipart/form-data' }
end.to broadcast_to(press_release).with_action(:replace).and broadcast_to(press_release).with_action(:replace)

5. 替代方案：直接监听ActionCable广播 #

如果broadcast_to断言始终失效，可直接拦截ActionCable的广播事件进行验证：

before do
  @broadcast_messages = []
  allow(ActionCable.server).to receive(:broadcast) do |stream, message|
    @broadcast_messages << message if stream == press_release.to_global_id.to_s
  end
end

it "sends two Turbo Stream updates to the press release stream" do
  post press_release_images_path(press_release), params: params, headers: { 'Content-Type' => 'multipart/form-data' }
  
  expect(@broadcast_messages.size).to eq(2)
  # 可选：验证广播内容是否包含目标slot
  expect(@broadcast_messages.first).to include("slot_#{image_model.position}")
end

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