PHP订单导入报错：SerialService::validateOrder()接收null实例校验失败

AI 小北

2026-9-28

订单导入报错修复方案

错误根因

SerialService::validateOrder方法声明了必须接收EIC\SalesBundle\Entity\SalesOrderHeader类的实例作为参数，但实际调用时传入了null值，触发了PHP类型约束致命错误。null值来源于serializeDocumentToEic方法处理异常文档时的返回结果，代码中原有TODO注释已经标注了需要在此处做类型校验，但尚未落地。

修复步骤

第一步：在serializeDocumentToEic调用后新增实例校验，拦截无效返回值
修改SerialService.php中对应代码段：

$order = $this->serializeDocumentToEic($document);
// 新增以下校验逻辑，落地原有TODO要求
if (!$order instanceof \EIC\SalesBundle\Entity\SalesOrderHeader) {
    $errorMessage = sprintf("文档ID#%s转换失败，未生成有效订单实例", $document->getId());
    $this->emailError($errorMessage);
    continue;
}
// 原有后续逻辑保持不变
$class = get_class($order);
$orders[] = $order;
$json = $this->serializer->serialize($order, 'json');
$valid = $this->validateOrder($order);

第二步：可选优化，给validateOrder方法增加空值兼容，避免异常漏网导致整个批量任务中断
修改validateOrder方法声明和前置逻辑：

// 参数前加?标识允许为null
protected function validateOrder(?SalesOrderHeader $order){
    // 新增空值判断
    if ($order === null) {
        return 'Error: 订单实例为空，校验终止';
    }
    // 原有校验逻辑保持不变
    $error = false;
    $errorMessage = '';
    // ...后续代码
}