如何在创建客户的主接口函数中正确返回多个子函数的错误？

当前createCustomer接口存在的核心问题：客户基础信息保存成功后，后续的saveCustomerAdditionalDetails()和createThirdParty()执行失败时，接口仍返回成功响应，调用方无法感知子流程错误；同时已保存的基础信息会残留，导致数据状态不一致。

要解决这个问题，核心是保证客户创建流程的原子性——要么所有步骤全部成功，要么全部回滚；同时在子流程失败时，及时返回明确的错误信息给调用方。具体实现步骤如下：

1. 改造子函数，让它们反馈执行状态 #

修改saveCustomerAdditionalDetails()和createThirdParty()，让它们在执行失败时抛出异常（推荐方式，更契合PHP/Laravel的错误处理逻辑），或者返回布尔值标记失败状态。

示例（抛出异常的子函数）：

// 保存客户附加信息的子函数
public function saveCustomerAdditionalDetails($customerId, Request $request)
{
    // 执行具体保存逻辑
    $saveResult = // 你的数据库操作或业务逻辑，返回布尔结果
    if (!$saveResult) {
        throw new \Exception("客户附加信息保存失败");
    }
    return true;
}

// 创建第三方关联的子函数
public function createThirdParty($customerId, Request $request)
{
    $createResult = // 第三方关联创建逻辑
    if (!$createResult) {
        throw new \Exception("第三方关联记录创建失败");
    }
    return true;
}

2. 用数据库事务包裹完整流程 #

在createCustomer中开启数据库事务，确保任何一步失败时，回滚已保存的客户基础信息，同时捕获异常并返回错误响应。

修改后的createCustomer代码 #

public function createCustomer(Request $request)
{
    // 开启数据库事务
    DB::beginTransaction();
    try {
        // 存储客户基础信息
        $customer = $this->clientCustomerepository->createCustomer([$request]);

        if (!$customer->customer_id) {
            throw new \Exception("客户基础信息创建失败");
        }

        // 执行附加信息保存
        $this->saveCustomerAdditionalDetails($customer->customer_id, $request);

        // 按需执行第三方关联创建
        if ($request['is_third_party']) {
            $this->createThirdParty($customer->customer_id, $request);
        }

        // 所有步骤成功，提交事务
        DB::commit();
        return APIResponse::format(201, 'success', '客户创建成功', $customer, null);
    } catch (\Exception $e) {
        // 任何步骤失败，回滚事务
        DB::rollBack();
        // 返回包含具体原因的错误响应
        return APIResponse::format(400, 'failed', $e->getMessage(), null);
    }
}

3. 可选：自定义业务异常实现细粒度错误分类 #

如果需要区分不同类型的错误（比如返回不同HTTP状态码），可以自定义业务异常类，让错误反馈更精准：

// 自定义异常类示例
class CustomerAdditionalDetailsFailedException extends \Exception {}
class ThirdPartyCreationFailedException extends \Exception {}

然后在子函数中抛出对应异常，主函数中针对性捕获：

catch (CustomerAdditionalDetailsFailedException $e) {
    DB::rollBack();
    return APIResponse::format(422, 'failed', '客户附加信息保存失败', null);
} catch (ThirdPartyCreationFailedException $e) {
    DB::rollBack();
    return APIResponse::format(422, 'failed', '第三方关联创建失败', null);
} catch (\Exception $e) {
    DB::rollBack();
    return APIResponse::format(400, 'failed', '客户创建失败：'.$e->getMessage(), null);
}

• 原子性保障：通过数据库事务避免出现“基础信息已保存，附加信息缺失”的不一致数据状态。
• 明确错误反馈：子流程失败时，将具体原因返回给调用方，便于排查问题。
• 逻辑清晰性：try-catch结构清晰划分成功/失败分支，代码可读性更强。

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