GraphQL多对多pivot使用connect报Array to string conversion错误

场景说明 #

两张存在多对多关联的表Element和Measurement，配套的ElementMeasurement pivot中间表包含可选属性template_id，该字段是指向另一条Element记录的外键。在pivot属性中使用connect操作时触发Array to string conversion错误。

模型定义 #

class Measurement extends Model {
    public function elements(): BelongsToMany {
        return $this->belongsToMany(Element::class)->using(ElementMeasurement::class)->withPivot('template_id');
    }
}

class Element extends Model {
    public function measurements(): BelongsToMany {
        return $this->belongsToMany(Measurement::class)->using(ElementMeasurement::class)->withPivot('template_id');
    }
}

class ElementMeasurement extends Pivot {
    public function element(): BelongsTo {
        return $this->belongsTo(Element::class);
    }

    public function measurement(): BelongsTo {
        return $this->belongsTo(Measurement::class);
    }

    public function template(): BelongsTo {
        return $this->belongsTo(Element::class, 'template_id');
    }
}

GraphQL Schema定义 #

type Element {
    id: Int!
    measurements: [Measurement!]! @belongsToMany
    pivot: ElementMeasurementPivot
}

type Measurement {
    id: Int!
    elements: [Element!] @belongsToMany
    pivot: ElementMeasurementPivot
}

input MeasurementInput {
    name: String
    elements: ElementMeasurementInput
}

type ElementMeasurementPivot {
    template: Element @belongsTo
}

input ElementMeasurementInput {
    connect: [ConnectElementMeasurement!]
}

input ConnectElementMeasurement {
    id: Int!
    template: ElementBelongsTo
}

正常运行的查询示例 #

以下查询可正常执行，说明框架可正确识别pivot上的关联关系：

{
    measurements {
        id
        elements {
            id
            pivot {
                template {
                    id
                }
            }
        }
    }
}

触发错误的Mutation示例 #

执行以下创建操作时抛出错误：

mutation {
    createMeasurement(input: {
        elements: {
            connect: [
                {
                    id: 1
                },
                {
                    id: 2
                    template: {
                        connect: 1
                    }
                }
            ]
        }
    })
}

错误特征 #

• 传入带template: {connect: 1}的嵌套关联参数时，抛出Array to string conversion错误
• 不传入template字段时，mutation可正常执行
• 将schema中template字段类型改为普通Int类型、直接传入template: 1时可正常运行，但该写法不符合关联操作规范

该错误是Laravel Lighthouse GraphQL框架对多对多关联pivot字段的写入逻辑限制导致：

1. 处理@belongsToMany的connect写入操作时，框架默认将connect数组内除关联主键id外的所有字段，直接作为pivot表的原始字段值，拼接入pivot记录的插入SQL参数中
2. 传入的template: {connect:1}是嵌套关联的操作结构，属于数组类型，框架默认没有识别到这是pivot模型上定义的BelongsTo关联，直接将该数组作为template_id字段的写入值，触发数组转字符串的类型错误
3. 查询场景能正常运行，是因为查询流程是在获取pivot记录后再按需加载关联关系，和写入时的参数解析是两套独立逻辑，因此查询正常不代表写入流程支持pivot上的嵌套关联操作。

方案1：自定义参数预处理（最符合关联操作规范） #

在mutation执行前增加参数预处理钩子，手动解析pivot上的嵌套关联结构，将其转换为pivot表实际需要的外键值：

// 在createMeasurement对应的resolver/middleware中提前处理输入参数
$input = $args['input'];
foreach ($input['elements']['connect'] as &$connectItem) {
    if (isset($connectItem['template']['connect'])) {
        // 将嵌套connect结构转换为pivot表字段值
        $connectItem['template_id'] = $connectItem['template']['connect'];
        unset($connectItem['template']);
    }
}
$args['input'] = $input;
// 后续继续执行原有模型创建、关联绑定逻辑即可

该方案不需要修改前端调用的关联写法，完全符合GraphQL关联操作的规范。

方案2：调整schema输入定义 #

如果不想增加预处理逻辑，可以修改ConnectElementMeasurement输入类型，直接定义外键字段，在字段注释中说明对应关联：

input ConnectElementMeasurement {
    id: Int!
    template_id: Int @rename(attribute: "template_id")
}

调用时直接传template_id: 1即可，缺点是不符合嵌套关联的标准写法。

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