TYPO3 Form Finisher可覆写Email数组问题排查求助

1. 新增键值对成独立数组、无法融入原数组 #

TYPO3 12调整了TCA数组的合并逻辑，尤其是针对type='array'或inline类型字段的处理，你可以从这些方向排查：

• 检查TCA对应字段配置，确保config['type'] = 'array'，同时设置config['default'] = []——避免空值被解析为字符串，打乱数组结构。
• 若通过overrideChildTca或扩展TCA数组实现覆写，不要直接用数组追加，改用TYPO3自带的\TYPO3\CMS\Core\Utility\ArrayUtility::mergeRecursiveWithOverrule()方法手动合并，确保新增键值对插入到逻辑位置，而非堆在数组底部。
• PHP调用数组时先做类型校验：

$emailArray = is_array($record['your_field']) ? $record['your_field'] : [];

避免将字符串当作数组处理。

2. 已存储数据/字段无法显示 #

TYPO3 12对数据序列化和权限控制的规则更严格，可按以下方式处理：

• 检查字段的config['serialization']配置：TYPO3 11可能默认使用serialize存储，而12推荐用json。如果之前存的是序列化数据，需要编写升级脚本将其转换为JSON格式，否则无法正常读取。
• Fluid视图渲染时先确认变量类型再遍历：

<f:if condition="{emailArray} instanceof Array">
    <f:for each="{emailArray}" as="email">{email}</f:for>
</f:if>

避免直接遍历非数组类型的变量。

• 检查后台用户的字段权限：TYPO3 12对权限控制更细致，确保对应字段在access配置中被允许访问。

3. 空数组触发"Cannot access offset of type string on string"错误 #

这个错误的核心是空值被存储为字符串（如空字符串），而非空数组，解决方法如下：

• 在TCA中强制设置config['default'] = []，确保字段默认值为空数组。
• 读取数据时统一做类型转换：

$emailArray = $record['your_email_field'] ?? [];
if (!is_array($emailArray)) {
    $emailArray = [];
}

• 写入数据时避免传入空字符串，确保所有写入操作都传递数组类型的值。

通用排查要点 #

• 清除TYPO3所有缓存（包括配置缓存、页面缓存）：12版本的缓存对TCA变更敏感度更高，不清理缓存可能导致配置不生效。
• 对照官方文档，查看TYPO3 11与12在type='array'、serialization、overrideChildTca等配置项上的差异，版本变更的细节往往是问题根源。
• 开启调试模式查看数据库中字段的实际存储值，确认是JSON数组还是字符串，直接定位数据存储层面的问题。

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