PHP长运行脚本设ignore_user_abort(true)后仍阻塞页面加载问题

你的核心问题是：虽然AJAX能立即收到响应，但页面刷新后仍会等待长导出任务完成，说明原请求进程并未真正与客户端断开，后台任务的执行仍在阻塞后续请求（可能和Apache进程模型、输出缓冲或连接处理逻辑有关）。结合你Windows+Apache+PHP7.4的环境，给出以下针对性解决办法：

1. 修复HTTP头部与输出缓冲流程 #

你的输出缓冲操作存在顺序问题，且Windows环境下Apache对flush()的处理有特殊性，调整代码如下：

// 彻底清空所有前置输出缓冲
while (ob_get_level() > 0) {
    ob_end_clean();
}

// 发送断开连接的头部，确保格式正确
header("Connection: close");
header("Content-Type: application/json");
header("Content-Encoding: none");
ignore_user_abort(true);
set_time_limit(3600);

ob_start();

// 执行插入操作（修复SQL注入风险）
$filepath = DOL_DOCUMENT_ROOT . '/exports/export-' . date('Ymd-his');
if (!file_exists($filepath)) {
    mkdir($filepath, 0777, true);
}

$sql = "INSERT INTO export_process(folder,fk_user) VALUES ('" . $db->escape($filepath) . "', {$user->id});";
$resSql = $db->query($sql);
if (!$resSql) {
    echo json_encode(['error' => $db->lasterror()]);
    $size = ob_get_length();
    header("Content-Length: $size");
    ob_end_flush();
    flush();
    // 关键：PHP-FPM环境下用此函数立即结束请求
    if (function_exists('fastcgi_finish_request')) {
        fastcgi_finish_request();
    }
    exit();
}

echo json_encode(['success' => true]);
$size = ob_get_length();
header("Content-Length: $size");
ob_end_flush();
flush();

// 强制结束客户端连接
if (function_exists('fastcgi_finish_request')) {
    fastcgi_finish_request();
} else {
    // 针对mod_php环境，循环刷新并关闭缓冲
    while (ob_get_level() > 0) {
        ob_end_flush();
    }
    flush();
}

// 后台执行长导出任务
// 注意：确保数据库连接不会提前断开，必要时重新建立连接
// 进度更新操作需确保SQL执行后立即提交（避免锁表）

关键调整点：

• 循环清空所有输出缓冲，避免前置代码输出导致头部发送失败
• 补充Content-Type头部，确保AJAX正确解析响应
• 用$db->escape()修复原代码的SQL注入风险
• 优先使用fastcgi_finish_request()（若Apache配置了PHP-FPM），直接让Web服务器结束请求，PHP脚本后台继续运行

2. Windows Apache环境的特殊配置 #

若你的Apache使用mod_php而非PHP-FPM，flush()可能无法立即生效，需额外配置：

• 在php.ini中设置output_buffering = Off
• 脚本开头添加ob_implicit_flush(true);，自动刷新输出
• 确保服务器未启用gzip压缩（已设置Content-Encoding: none，需验证生效）

3. 更可靠的后台任务方案（推荐） #

Windows环境下，用独立进程运行长任务是最稳定的方式，彻底分离请求响应与后台逻辑：

// ... 前面的插入数据库逻辑不变 ...

echo json_encode(['success' => true]);
$size = ob_get_length();
header("Content-Length: $size");
ob_end_flush();
flush();
if (function_exists('fastcgi_finish_request')) {
    fastcgi_finish_request();
}

// 启动独立后台进程执行导出
$exportScript = DOL_DOCUMENT_ROOT . '/cli/export_task.php';
$args = escapeshellarg($filepath) . ' ' . escapeshellarg($user->id);
// start /B 命令让脚本在后台运行
$command = "start /B php \"$exportScript\" $args";
// popen+pclose 启动进程，避免阻塞原脚本
pclose(popen($command, 'r'));

exit(); // 原脚本立即结束

创建export_task.php处理导出逻辑：

<?php
// 初始化Dolibarr环境（根据框架调整）
require_once 'main.inc.php';

$filepath = $argv[1];
$userId = $argv[2];

// 执行长导出任务，每一步更新export_process表进度
// ... 你的导出代码 ...

这种方式完全隔离了请求与后台任务，无论Apache配置如何，都不会影响用户后续页面操作。

4. 数据库相关注意事项 #

• 插入export_process后，确保无未提交事务，避免表锁导致后续进度查询请求阻塞
• 后台任务更新进度时，使用短事务或直接执行UPDATE后立即提交
• 若任务运行时间过长，需重新建立数据库连接，避免连接超时

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