CakePHP4使用TreeBehavior保存数据时lft、rght字段为NULL如何解决

问题原因 #

该问题是CakePHP默认Inflector（词形转换器）的英语复数规则不匹配非英语单词变形导致的：

• rubrique是法语单词，复数为rubriques，不符合英语复数变形逻辑
• CakePHP内部处理表、实体、行为的映射关系时依赖Inflector做单复数转换，映射出错后Tree Behavior无法正常触发lft、rght字段的自动计算逻辑，所以保存时值为NULL
• 改为rubrics后符合英语rubric→rubrics的标准复数规则，映射恢复正常，Tree Behavior可以正常工作

解决方案 #

方案1：注册自定义不规则复数规则（推荐） #

在config/bootstrap.php中添加如下代码，告知Inflectorrubrique和rubriques的单复数对应关系：

// 引入Inflector类
use Cake\Utility\Inflector;

// 注册不规则复数变形
Inflector::rules('singular', ['irregular' => ['rubriques' => 'rubrique']]);
Inflector::rules('plural', ['irregular' => ['rubrique' => 'rubriques']]);

添加后清除应用缓存即可恢复正常，不需要修改现有表名、类名。

方案2：显式指定Table类的实体映射 #

在RubriquesTable的initialize方法中强制指定对应实体类，避免Inflector自动映射出错：

public function initialize(array $config): void
{
    parent::initialize($config);
    $this->setTable('rubriques');
    // 新增这行强制指定实体类
    $this->setEntityClass(\App\Model\Entity\Rubrique::class);
    $this->addBehavior('Tree');
}

方案3：显式配置Tree Behavior的字段参数 #

手动指定Tree Behavior需要的三个字段，避免自动推断出错：

$this->addBehavior('Tree', [
    'parentField' => 'parent_id',
    'leftField' => 'lft',
    'rightField' => 'rght',
]);

排查补充 #

如果以上操作后仍未生效，可以先检查保存时的错误信息：

$rubrique = $this->Rubriques->newEntity([
    'name' => 'Try',
    'parent_id' => null
]);
if ($this->Rubriques->save($rubrique)) {
    debug('保存成功');
} else {
    // 输出验证/保存错误
    debug($rubrique->getErrors());
}
die();

同时记得清除tmp/cache目录下的ORM缓存，避免旧的映射关系影响。

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