PHP 8.0+ 单元测试内存耗尽问题排查与解决方案

laravel 9 升级至 php 8.0+ 后，phpunit 测试因隐式内存限制覆盖（如 `ini_set(‘memory_limit’, …)`）导致“allowed memory size exhausted”错误，即使 docker 中已配置 `php_memory_limit=2g` 仍会触发默认 128mb 限制。

在 Laravel 9 与 PHP 8.0.16（尤其是 Alpine 环境）组合下运行 PHPUnit 时，出现类似 Allowed memory size of 134217728 bytes exhausted（即 128MB）的致命错误，是一个典型但易被忽视的配置冲突问题。值得注意的是：该错误并非源于实际内存不足，而是 PHP 运行时被意外重置为低内存限制——即便你在 docker-compose.yml 或 Dockerfile 中通过 ENV PHP_MEMORY_LIMIT=2G 显式声明，也未必生效。

? 根本原因：ini_set() 覆盖了全局配置

PHP 的 memory_limit 是一个 PHP_INI_ALL 级别指令，意味着它既可通过 php.ini、环境变量（如 PHP_MEMORY_LIMIT），也可在运行时通过 ini_set() 动态修改。而关键在于：ini_set() 的优先级高于环境变量和 php.ini。

在 Laravel 9 升级过程中，部分遗留代码、第三方包或自定义服务提供者中可能含有如下语句：

// ⚠️ 危险示例：硬编码低内存限制（常见于旧版调试脚本或兼容性补丁） ini_set('memory_limit', '256M');

一旦该代码在 PHPUnit 启动早期（例如 TestCase.php、CreatesApplication trait 或 phpunit.xml 中加载的 bootstrap 文件）被执行，就会强制将整个测试进程的内存上限锁定为 256M（甚至更低，如 128M）。更隐蔽的是：若该调用发生在 php.ini 加载之后、但 PHPUnit 初始化之前，它会直接覆盖你 Docker 中设置的 2G，且后续无法通过 phpinfo() 在 CLI 中直观察觉——因为 phpinfo() 默认显示 Web SAPI 配置，而 PHPUnit 运行在 CLI SAPI 下。

立即学习“PHP免费学习笔记（深入）”；

✅ 验证方法：在 tests/TestCase.php 的 setUp() 开头添加：public function setUp(): void { parent::setUp(); echo “Current memory_limit: ” . ini_get(‘memory_limit’) . PHP_EOL; }运行 docker-compose run –rm phpunit，你会看到输出为 128M 或 256M，而非预期的 2G。

? 正确修复方案

1. 全局搜索并移除所有 ini_set(‘memory_limit’, …)

使用以下命令扫描项目（含 vendor，但优先检查自定义代码）：

grep -r "ini_set.*memory_limit" --include="*.php" . --exclude-dir=vendor

重点关注：

• tests/ 目录下的基类或引导文件
• app/Providers/ 中的 AppServiceProvider 或自定义 Provider
• bootstrap/app.php 或 phpunit.xml 中指定的 bootstrap 文件

2. 确保 Docker 中的 PHP_MEMORY_LIMIT 正确传递至 CLI

Alpine 镜像中，PHP_MEMORY_LIMIT 环境变量需通过 docker-php-ext-* 脚本或 php.ini 注入。当前 Dockerfile 存在隐患：ENV PHP_MEMORY_LIMIT=2G 仅设置环境变量，未写入 php.ini。应显式生成配置：

# 替换原 ENV 行，追加以下内容到 php.dockerfile RUN echo "memory_limit = 2G" > /usr/local/etc/php/conf.d/memory-limit.ini

? 提示：Alpine 的 PHP 配置目录通常为 /usr/local/etc/php/conf.d/，.ini 文件按字母序加载，确保 memory-limit.ini 名称靠前（如 00-memory-limit.ini）。

3. （可选）在 phpunit.xml 中强制覆盖

作为兜底措施，在 phpunit.xml 的 节点内显式声明：

此方式由 PHPUnit 自身解析，优先级高于 php.ini，但无法覆盖已执行的 ini_set()。

? 注意事项与最佳实践

• 不要在测试代码中调用 ini_set()：单元测试应保持环境纯净，内存策略应由基础设施（Docker/CI）统一管控。
• 避免 Alpine + gnu-libiconv 的潜在冲突：你使用的 gnu-libiconv preload 可能引发 PHP 8 内存管理异常（尤其在大量字符串操作的迁移中）。如问题持续，尝试切换至 php:8.0.16-fpm（debian）镜像对比验证。
• 监控真实内存使用：在 phpunit 命令前添加 php -d memory_limit=2G -m 验证模块加载是否正常，并用 docker stats 观察容器实际内存占用。
• Laravel 9 的迁移变更：Schema::create() 在 Laravel 9 中启用了更严格的语法检查和动态绑定，若迁移中存在未闭合的匿名函数或循环引用（如 $this->foo = function() use ($this) { … }），也可能加剧内存泄漏——但此类问题通常伴随其他错误，非单纯 memory_limit 报错。

✅ 总结

遵循以上步骤，99% 的同类问题可立即解决。记住：在 PHP 8+ 的严格模式下，“配置即代码”的一致性比以往任何时候都更重要。