Laravel 10测试内存泄漏排查：继承BaseTestCase触发问题

我们的Laravel 10应用测试阶段存在明显内存泄漏，从Laravel 8升级至10后问题仍未解决。使用Roave/no-leaks工具检测发现，绝大多数甚至全部测试都存在内存泄漏现象。

有意思的是，当测试类不继承Laravel自带的Illuminate\Foundation\Testing\TestCase，而是直接继承原生PHPUnit\Framework\TestCase时，泄漏就消失了。

测试类示例 #

存在泄漏的测试类结构：

<?php

namespace Tests\Unit;

use Illuminate\Foundation\Testing\TestCase as BaseTestCase;

class SampleTest extends BaseTestCase

无泄漏的测试类结构：

<?php

use PHPUnit\Framework\TestCase;

class SampleTest extends TestCase

如何区分是框架自身问题还是配置问题？ #

框架层面的可能原因

Laravel的测试基类Illuminate\Foundation\Testing\TestCase会在每个测试前初始化整个应用容器，过程中可能产生无法自动清理的引用：

• 容器中的单例、绑定实例在测试结束后未被彻底销毁，残留引用占用内存
• 测试过程中注册的全局事件监听器、中间件、服务提供者，在tearDown阶段未完全清理
• 应用初始化时加载的配置、路由、模型等资源，存在全局静态引用无法释放

配置与自定义代码的排查点

这些场景更可能是本地配置或自定义代码导致的：

• PHPUnit配置：检查phpunit.xml是否开启processIsolation="true"。若未开启，多个测试共享同一进程，资源残留会持续积累内存
• 自定义代码：排查自研的服务提供者、测试辅助类，是否存在未清理的静态属性、全局变量，或手动创建的单例未在测试销毁阶段释放
• 外部资源：测试中使用的数据库、Redis等连接，是否在测试结束后正确关闭
• 检测工具配置：确认Roave/no-leaks的检测规则无误，不过大量测试都出现泄漏的话，误报概率极低

实用排查步骤 #

1. 开启进程隔离：在phpunit.xml中设置processIsolation="true"后重新运行测试。若泄漏消失，说明是跨测试的资源残留问题，大概率是配置或自定义代码导致
2. 简化测试定位：写一个最基础的Laravel测试类（比如仅包含$this->assertTrue(true);），用Roave/no-leaks检测。若仍泄漏，说明是Laravel测试基类本身的问题；若没有泄漏，再逐步添加业务代码定位根源
3. 内存快照对比：在测试的setUp和tearDown前后用memory_get_usage()打印内存数值，定位哪一步内存增长后未释放
4. 检查服务提供者：查看自定义服务提供者的register和boot方法，是否绑定了不必要的单例，或注册了全局回调但未清理

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