register_shutdown_function报Invalid shutdown callback错误排查

两种写法的错误原因分别如下：

• 最初写法register_shutdown_function($this->shutdownFunction())触发无效回调错误：
  方法名后加括号代表立刻执行该方法，而非将方法作为回调传入注册函数。执行shutdownFunction()后返回的是JsonResponse对象，不是PHP可识别的合法回调类型，因此直接报错。方法内dump()内容立刻输出也是同理——代码运行到注册行就直接执行了方法逻辑，根本没有等脚本终止后再触发。
• 调整为register_shutdown_function([$this, 'shutdownFunction'])后回调不生效：
  1. 最大执行时间超时属于E_ERROR级致命错误，Laravel全局异常处理器会优先捕获该类错误，直接输出默认错误响应，框架自身的shutdown逻辑会提前抢占流程，导致自定义回调要么被覆盖，要么执行时HTTP响应已经发送完成。
  2. 回调本身逻辑有误：shutdown函数触发时PHP已进入脚本收尾阶段，Laravel的自动响应解析、发送流程早已结束，函数内return response()->json()的返回值不会被框架处理，自然无法发给客户端。

需要调整错误判断、输出清理、手动发送响应的逻辑，参考如下：

class ProfitAndLossController extends Controller
{
    private function shutdownFunction(){
        $lastError = error_get_last();
        // 仅在触发最大执行时间超时时执行自定义逻辑
        if ($lastError && $lastError['type'] === E_ERROR && str_contains($lastError['message'], 'Maximum execution time')) {
            // 清空所有已生成的输出缓冲区，避免和默认错误内容混排
            while (ob_get_level()) {
                ob_end_clean();
            }
            // 手动发送HTTP响应
            header('Content-Type: application/json');
            http_response_code(403);
            echo json_encode(['error_message' => Lang::get('listings.file_too_large')]);
            exit; // 终止后续所有收尾逻辑，避免被框架默认响应覆盖
        }
    }

    public function import(ImportListingRequest $request){
        $import = new ProfitAndLossImport();
        set_time_limit(30);
        // 注册回调传入可调用数组，不要加括号主动执行方法
        register_shutdown_function([$this, 'shutdownFunction']);
        Excel::import($import, request()->file('pl'));
        return $import;
    }
}

• shutdown函数注册逻辑必须放在可能触发超时的操作之前，否则注册前超时的话回调不会触发。
• Web请求本身不适合处理耗时超过30秒的操作，大文件Excel导入建议改为队列异步处理，前端轮询任务状态，用户体验远好于超时后提示。
• 如果项目自定义过app/Exceptions/Handler.php的错误渲染逻辑，需要确认没有对超时错误做单独的响应拦截，否则会覆盖自定义输出。

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