EdgeDB 嵌套函数中的 DML 查询编译错误解析

问题背景

在使用 EdgeDB 数据库时，开发者尝试通过创建一系列实用函数来实现基于 JSON 数据的对象插入和检索功能。具体场景是：当 JSON 数据是字符串/UUID 时检索对象，当 JSON 是对象时则执行插入操作。

这种设计模式在单独插入单个对象时工作正常，但当尝试通过嵌套函数调用插入关联数据时，系统会抛出以下错误信息：

InternalServerError: Can't compile ref to inline parameter ns~3@@(__derived__::expr~31)

技术分析

函数设计架构

开发者设计了三层函数结构：

1. 基础插入函数：insert_institution 直接执行机构数据的插入操作
2. 智能判断函数：insert_or_create_institution 根据输入 JSON 类型决定是插入新记录还是查询现有记录
3. 顶层聚合函数：insert_person 处理人员数据及其关联机构

问题重现条件

当执行以下查询时会出现编译错误：

select (insert_person(<json>$0)) { ** }

传入的 JSON 数据结构包含人员基本信息及其关联机构：

{
  "first_name": "jane",
  "last_name": "doe",
  "alias": "jdoe",
  "institutions": [
    {
      "name": "test",
      "code": "TEST",
      "kind": "Lab"
    }
  ]
}

底层原因

这个错误源于 EdgeDB 编译器在处理嵌套的内联函数时存在缺陷。具体来说：

1. 当 insert_person 函数调用 insert_or_create_institution 时
2. 后者又可能调用 insert_institution
3. 在这种多层嵌套的 DML (数据操作语言) 场景下
4. 编译器无法正确处理参数引用的作用域

解决方案与建议

临时解决方案

对于需要立即使用的场景，可以考虑：

1. 将嵌套的函数调用拆分为多个独立查询
2. 在应用层实现逻辑判断而非数据库函数层
3. 使用事务包装多个独立操作

最佳实践

在设计 EdgeDB 数据操作逻辑时：

1. 避免在函数中嵌套多层 DML 操作
2. 对于复杂的数据关系操作，考虑使用脚本(script)而非函数
3. 保持函数的单一职责原则
4. 对关键操作添加明确的错误处理

技术展望

这类问题反映了 EdgeDB 在函数式编程与 DML 操作结合方面的挑战。随着版本迭代，我们可以期待：

1. 更健壮的嵌套函数编译机制
2. 更清晰的错误提示信息
3. 更完善的 DML-in-function 支持

对于需要复杂数据操作的场景，建议关注 EdgeDB 的版本更新日志，及时获取相关改进信息。