Laravel 8.12版本辅助函数dd()未按预期终止脚本执行问题

核心原因 #

• 自定义函数覆盖原生实现：若项目代码或引入的第三方扩展包提前定义了同名dd()函数，且未加入die()/exit()终止逻辑，就会出现打印后脚本继续运行的问题。Laravel原生dd()的底层逻辑是先打印传入变量，再调用exit(1)终止程序，自定义版本遗漏终止步骤是最常见的诱因。
• 常驻内存运行环境不兼容：若项目运行在Swoole、Workerman等常驻内存框架中，默认的exit()/die()仅会终止当前协程/单次任务，不会停止脚本执行，原生dd()的终止逻辑会直接失效。
• 请求被重复触发：两次输出可能来自不同请求，比如前端重复提交接口、路由/中间件逻辑重复调用store方法，会导致第一次请求输出Test 1、第二次请求输出Test 2，看起来像是dd()未生效。
• Laravel核心文件被篡改：若vendor/laravel/framework/src/Illuminate/Support/helpers.php中的dd()函数被修改，移除了终止执行的代码，也会触发该异常。

排查步骤 #

• 定位dd()实际实现：在dd('Test 1')前插入代码var_dump(new ReflectionFunction('dd'));，查看返回的函数定义路径，确认是否为Laravel原生的helper文件。
• 校验运行环境：确认当前项目是否运行在常驻内存环境中，这类环境原生dd()本身不支持终止全脚本执行。
• 排查请求次数：在store方法开头加入日志记录logger()->info('store方法调用');，调用接口后查看日志条数，若条数大于1则说明是多次请求导致的问题，和dd()本身无关。
• 校验核心文件逻辑：打开Laravel原生helper文件查看dd()实现，原生代码如下：

function dd(...$vars)
{
    foreach ($vars as $v) {
        VarDumper::dump($v);
    }

    exit(1);
}

若代码中缺少exit(1)行，说明核心文件已被改动。

修复方案 #

• 自定义函数覆盖场景：删除项目中自定义的dd()函数，或在自定义dd()末尾补充exit()终止逻辑。
• 常驻内存环境场景：调试阶段使用对应环境适配的调试终止函数（如Swoole环境下的sdd()），或手动在dd()后追加对应环境的终止逻辑，生产环境移除所有调试代码即可。
• 重复请求场景：排查前端重复提交逻辑，或修复路由、中间件中重复调用控制器方法的问题。
• 核心文件篡改场景：执行composer require laravel/framework:8.12 --with-all-dependencies还原核心文件，或手动在原生dd()函数中补回exit(1)逻辑。

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