TYPO3 v12迁移后Extbase DataMapper与PropertyMapper本地化ID映射冲突

问题核心 #

TYPO3 v12迁移后，Extbase的DataMapper逻辑变更，返回uid_localizedUid格式的复合标识符，Fluid选择框也会渲染该值到前端选项中，但保存记录时PropertyMapper会抛出异常：Exception while property mapping at property path "branche": The identity property "17_59" is no UID.

原因分析 #

1. 属于官方已知Bug
   你提到的工单105319是官方确认的兼容性问题，核心是Extbase各组件对本地化记录标识符的处理逻辑未完全对齐：

   • DataMapper按新规则生成复合ID，Fluid视图助手同步渲染该值
   • PropertyMapper未同步更新解析逻辑，仍默认校验纯UID格式

2. 未遗漏配置项
   目前TYPO3 v12没有针对该场景的额外TCA或Repository配置要求，无需手动添加特殊配置。

临时修复方案 #

如果需要在官方补丁发布前解决问题，可选择以下两种方式：

方式1：重写PropertyMapper类型转换器 #

自定义PersistentObjectConverter，添加对复合ID的解析逻辑：

<?php
namespace YourVendor\YourExtension\Property\TypeConverter;

use TYPO3\CMS\Extbase\Property\TypeConverter\PersistentObjectConverter as CorePersistentObjectConverter;

class PersistentObjectConverter extends CorePersistentObjectConverter
{
    protected function getUidFromIdentityString(string $identity): int
    {
        // 拆分复合ID，提取原始UID
        if (str_contains($identity, '_')) {
            return (int)explode('_', $identity)[0];
        }
        return parent::getUidFromIdentityString($identity);
    }
}

在Services.yaml中注册替换核心转换器：

TYPO3\CMS\Extbase\Property\TypeConverter\PersistentObjectConverter:
  class: YourVendor\YourExtension\Property\TypeConverter\PersistentObjectConverter

方式2：修改Fluid选择框输出值 #

在模板中手动指定选项值为原始UID，绕过复合ID：

<f:form.select property="branche" options="{branches}" optionValueField="uid" />

注意：此方式仅适用于无需区分本地化记录的场景，若业务依赖本地化记录关联，优先选择方式1

官方进展 #

工单105319已被标记为需修复的兼容性问题，后续TYPO3版本更新会同步PropertyMapper的解析逻辑，使其支持DataMapper生成的复合标识符格式，建议关注官方版本迭代。

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