Laravel Backpack多对多关联inline-create弹窗无字段问题

问题现象 #

• 关联inline-create功能此前运行正常，经过代码调整、依赖版本更新后无报错但失效
• 主模型为Image，配置两类模型关联：
  • 与Tags为多对多（many-to-many）关系
  • 与Category为从属（belongs-to）关系
• 异常表现：Category的inline-create功能可正常触发、加载字段、提交保存；触发Tags的inline-create时，模态请求正常返回200状态，但内容仅包含基础表单结构、底部操作按钮，无任何表单输入字段
• 前置排查确认：Tags的后台常规独立创建操作运行正常，未重写任何模态相关的系统视图文件

核心诱因 #

该问题是Backpack Pro 6.x版本迭代后多对多关联inline-create加载逻辑变更导致的兼容问题，无报错抛出，常见触发原因按概率从高到低排序：

1. setupCreateOperation场景拦截不兼容：版本更新后，inline-create请求的Panel场景标记从原来的create改为独立的inline-create。如果TagCrudController中写了仅允许普通create场景加载字段的判断逻辑，会直接跳过inline-create场景下的字段注册流程。而belongs-to类型关联的inline-create走的是另一套兼容加载逻辑，不受该变更影响，所以Category的功能正常。
2. 多对多关联字段配置缺失显式源指定：版本更新后多对多关联的inline-create不再自动fallback读取对应CrudController的create配置，如果字段定义里没有显式声明要加载的Crud控制器、实体名，会加载一个空的Panel实例返回，自然没有字段。
3. 多对多字段配置结构错误：如果把Tag模型本身的创建字段错误写到了pivot配置节点下，inline-create模态加载时会自动过滤pivot层级的配置，只读取关联模型本身的字段配置，导致字段丢失。

修复步骤 #

按顺序排查操作即可解决：

• 第一步：修改TagCrudController的创建操作场景判断，把inline-create加入白名单
  找到setupCreateOperation方法里的场景拦截逻辑，把判断条件改成同时兼容普通创建和行内创建场景：

protected function setupCreateOperation()
{
    // 修正前的错误写法会拦截inline-create请求：
    // if (!$this->crud->is('create')) return;

    // 修正后的判断逻辑
    if (!($this->crud->is('create') || $this->crud->is('inline-create'))) {
        return;
    }

    // 原有的字段注册、保存逻辑保持不变即可
    CRUD::field('name')->type('text');
    // 其余字段...
}

• 第二步：补全ImageCrudController中Tags关联字段的inline_create显式配置
  不要依赖系统自动解析关联源，手动指定实体名和对应Crud控制器路径：

// ImageCrudController的字段定义区域
CRUD::field('tags')->type('relationship')->inline_create([
    'entity' => 'tag', // 关联模型的单数实体名，和路由前缀保持一致
    'source' => TagCrudController::class, // 显式指定读取字段配置的控制器
    // 其余原有inline_create配置比如modal大小、按钮文字等保留即可
]);

• 第三步：检查字段配置结构，确保Tag模型的自有创建字段没有写到pivot节点下，中间表字段才需要放在pivot配置里。
• 第四步：执行缓存清理命令，消除旧配置缓存影响：

php artisan config:clear
php artisan cache:clear
php artisan backpack:cache

完成以上操作后强刷后台页面，Tags的inline-create模态即可正常加载所有字段。

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