本文介绍一种可靠、简洁的方法，使用 monolog 的 `testhandler` 捕获所有日志输出，并灵活断言其中是否包含至少一条符合预期的 log 消息（如“owner mail sent to”），避免 mock 多次调用导致的冲突与不可靠性。
在单元测试中验证日志行为时，直接对 LoggerInterface 进行多次 expects() 断言极易失败——因为 PHPUnit 的 Mock 机制要求每次方法调用严格匹配某一个预设期望，而实际代码中 info() 可能被调用多次、参数各不相同，导致后续期望无法满足（正如错误信息所示：“Parameter 0 … does not match expected value”）。
更健壮的替代方案是：不 mock 日志器，而是注入一个真实但可测试的日志器实例。Monolog 提供了专为测试设计的 TestHandler，它会静默收集所有日志记录，供测试后断言使用。
✅ 推荐实现方式（基于 Monolog TestHandler）
确保项目已安装 Monolog（通常 Laravel/Symfony 项目默认包含）：
composer require --dev monolog/monolog
在测试方法中按如下方式使用：
立即学习“PHP免费学习笔记（深入）”；
use Monolog/Logger;
use Monolog/Handler/TestHandler;
public function testSendEMailsLogsAtLeastOneExpectedMessage(): void
{
// 创建测试专用 logger + TestHandler
$testHandler = new TestHandler();
$logger = new Logger('mailing-test');
$logger->pushHandler($testHandler);
// 注入到被测 facade
$this->facade->setLogger($logger);
// 执行被测行为
$reportDto = new ReportDto('test', 'data'); // 替换为你的 DTO 实例
$this->facade->sendEMails($reportDto);
// 断言：只要任意一条 info 日志包含任一关键词，即通过
$this->assertTrue(
$testHandler->hasInfoThatContains('Owner mail sent to') ||
$testHandler->hasInfoThatContains('Pno mail sent to') ||
$testHandler->hasInfoThatContains('Group mail sent to'),
'Expected at least one of the email-sent confirmation messages was not logged'
);
}
? 补充断言技巧
TestHandler 还提供多种便捷断言方法，例如：
- $handler->hasInfo($message) —— 完全匹配日志内容（含上下文）
- $handler->hasInfoThatContains(‘sent to’) —— 子字符串匹配（推荐用于动态内容，如邮箱、ID）
- $handler->getRecords() —— 获取全部日志记录数组，支持自定义遍历与复杂校验
- $handler->hasWarningThatContains(…) / hasErrorThatContains(…) —— 按日志级别筛选
若需验证所有预期消息都出现（而非“至少一个”），可改为：
$this->assertTrue(
$testHandler->hasInfoThatContains('Owner mail sent to') &&
$testHandler->hasInfoThatContains('Pno mail sent to') &&
$testHandler->hasInfoThatContains('Group mail sent to'),
'All expected email-sent messages must be logged'
);
⚠️ 注意事项
- 确保被测类（如 MailingFacade）接受 Psr/Log/LoggerInterface 类型依赖，并正确调用 info() 等方法（非私有封装绕过）；
- 若项目未使用 Monolog，可自行实现轻量 CollectingLogger（实现 LoggerInterface，内部保存 $records = []），但 TestHandler 是最省心、经过充分验证的选择；
- 避免在测试中 createMock(LoggerInterface::class) 并链式设置多个 expects() —— 这本质上违背了“单一职责断言”原则，且难以调试。
通过将日志视为可观测的副作用输出而非需要模拟的协作对象，你不仅能精准验证业务逻辑触发路径，还能让测试更稳定、更具可维护性。