Laravel Dusk 中 assertStringContainsString 断言消息显示问题解析

问题现象

在使用 Laravel Dusk 进行浏览器测试时，开发者发现 assertStringContainsString 断言失败时不会显示自定义的错误消息，而 assertSame 断言则能正常显示。具体表现为：

• 当使用 $this->assertSame('foo', 'bar', 'My custom message.'); 时，测试输出会正确显示自定义消息
• 当使用 $this->assertStringContainsString('foo', 'bar', 'My custom message.'); 时，测试输出不会显示自定义消息

问题根源

经过排查，这个问题与 Laravel 生态系统中常用的 nunomaduro/collision 包有关。该包覆盖了 PHPUnit 的默认输出处理器，导致某些特定断言的错误消息显示行为出现异常。

解决方案验证

通过移除 nunomaduro/collision 包可以解决这个问题：

1. 执行 composer remove nunomaduro/collision --dev
2. 重新运行测试后，assertStringContainsString 的自定义消息能够正常显示

技术背景

nunomaduro/collision 是 Laravel 生态中一个优秀的错误处理包，它提供了更美观的 CLI 错误显示界面。但在处理某些 PHPUnit 断言时，它的自定义输出处理器可能无法完全兼容所有断言类型的消息显示逻辑。

建议解决方案

对于需要保留 nunomaduro/collision 但又需要完整断言消息显示的情况，可以考虑以下方案：

1. 临时解决方案：在关键测试中使用 assertSame 替代 assertStringContainsString
2. 长期解决方案：向 nunomaduro/collision 项目提交 issue，请求完善对各类 PHPUnit 断言消息的支持

开发者注意事项

当遇到测试断言消息显示异常时，应当考虑：

1. 检查是否使用了第三方包修改了 PHPUnit 的默认行为
2. 尝试在最小化环境中复现问题（如移除可能的干扰包）
3. 了解不同断言方法的预期行为和输出格式

这个问题提醒我们，在使用测试工具链时，第三方包可能会带来意料之外的行为变化，特别是在输出处理这种较为底层的功能上。