thinkphp - ThinkPHP 如何处理支付回调时先返回200再执行后续逻辑？

Question

thinkphp在接收支付回调的时候 如何先返回200给支付商在处理自己的逻辑？
就是项目之前都是接收了回调直接处理逻辑的，现在发现有些太久了 支付商那边得不到正确的状态码 一直重试。加上php没异步 所以这个东西比较麻烦，队列不考虑 因为项目不大 先记录后面用任务去跑 也不考虑。打算简单点解决 有没异步可以实现的呢

Answer 1

在ThinkPHP中处理支付回调时，为了先返回200 OK给支付商再执行后续逻辑，你可以使用PHP的fastcgi_finish_request()函数（如果使用PHP-FPM环境）或结合输出缓冲来模拟响应发送后继续执行。这个方法不需要队列或异步扩展，非常适合小型项目。以下是实现步骤和示例代码。

核心原理

• 问题背景：直接处理逻辑可能导致响应超时（如HTTP 504），支付商收不到200状态码而重发回调。

• 解决方案：

  1. 快速返回200响应给支付商。
  2. 然后继续执行你的业务逻辑（如更新订单状态）。
• 关键点：使用fastcgi_finish_request()（推荐）或ob_end_flush() + flush()关闭HTTP连接，让脚本在后台运行。

在ThinkPHP中的实现

在你的控制器方法中（例如NotifyController），添加以下逻辑。确保环境支持FastCGI（如PHP-FPM），否则用替代方案。

示例代码

namespace app\controller;

use think\Controller;

class NotifyController extends Controller
{
    public function handleCallback()
    {
        // 步骤1: 快速验证支付回调（必须快！避免耗时操作）
        $postData = $this->request->post();
        if (!$this->validateSignature($postData)) { // 示例验证方法
            header('HTTP/1.1 400 Bad Request');
            exit('Invalid signature');
        }

        // 步骤2: 立即返回200响应给支付商
        header('HTTP/1.1 200 OK');
        echo 'SUCCESS'; // 根据支付商要求返回字符串（如微信支付要求SUCCESS）
        
        // 步骤3: 结束HTTP请求，继续执行后续逻辑
        if (function_exists('fastcgi_finish_request')) {
            fastcgi_finish_request(); // PHP-FPM环境下推荐
        } else {
            // 非PHP-FPM环境（如Apache with mod_php）使用输出缓冲
            if (ob_get_level() > 0) {
                ob_end_flush();
            }
            flush();
        }

        // 步骤4: 从这开始执行你的业务逻辑（响应已发送，支付商已收到200）
        $this->processLogic($postData);
    }

    private function validateSignature(array $data): bool
    {
        // 快速验证签名（示例：实际需按支付商文档实现）
        return isset($data['sign']) && md5($data['order_id'] . 'your_secret') === $data['sign'];
    }

    private function processLogic(array $data)
    {
        // 这里执行耗时操作（如更新数据库、记录日志）
        // 例如：更新订单状态为已支付
        $orderId = $data['order_id'];
        // 假设使用ThinkPHP模型
        $order = \app\model\Order::find($orderId);
        if ($order) {
            $order->status = 'paid';
            $order->save();
        }
        // 可以添加日志记录 error_log('Payment processed: ' . $orderId);
    }
}

关键说明

• 为什么有效：

  • fastcgi_finish_request()：在PHP-FPM中发送响应并断开连接，脚本继续执行。
  • 替代方案：ob_end_flush() + flush()强制刷新输出缓冲区，模拟类似效果。
  • 响应时间：验证和返回200通常在100ms内完成，避免支付商重试。

• 注意事项：

  • 环境要求：确保使用PHP-FPM（phpinfo()查看Server API）。共享主机或旧环境可能不支持fastcgi_finish_request()，需测试替代方案。

  • 逻辑可靠性：响应已发送，后续逻辑失败无法通知支付商。务必：

    • 用try-catch处理异常（如数据库错误）。
    • 记录日志（error_log()或文件日志），便于调试。
  • 验证必须快速：不要在验证阶段做数据库操作，只做签名检查等内存计算。
  • 超时设置：脚本执行可能有超时限制（如PHP的max_execution_time）。在processLogic()中调用set_time_limit(0)禁用超时（谨慎使用）。

• 测试建议：

  • 模拟回调：使用curl或Postman发送请求，检查是否立即返回200。
  • 监控日志：确保后续逻辑执行成功。

这个方法简单高效，没有队列依赖，适合中小项目。如果后续逻辑失败率较高，建议添加本地重试机制（如保存到临时表后定时任务处理）。