TYPO3与DCE版本升级后图片上传字段异常、旧图片丢失的解决求助

• 核心原因说明：DCE 2.3及以上版本重构了FAL关联字段的默认生成规则，旧版本存储的FAL关联记录的fieldname标识与新版本自动生成的标识不匹配，才会出现后台读不到图片、前端缓存仍能展示的问题；直接修改配置后刷新丢失图片，是因为TYPO3会自动清除匹配规则不一致的FAL关联记录。
• 操作前置要求：操作前务必全量备份数据库、站点文件目录，再完成TYPO3和DCE的版本升级，升级后暂时不要修改任何DCE字段配置、不要清空全站缓存。
• 具体操作步骤：
  1. 执行数据库查询语句，获取旧字段的关联标识：

     SELECT DISTINCT fieldname FROM sys_file_reference WHERE tablenames = 'tx_dce_domain_model_dcecontent' AND fieldname LIKE '%<你的图片字段标识>%';
     

     请将语句中<你的图片字段标识>替换为你实际配置的DCE图片字段的名称，查询得到的结果即为旧版本存储的fieldname值。
  2. 进入DCE字段编辑界面，找到对应图片字段的「扩展TCA配置」区域，找到foreign_match_fields配置项，将其中fieldname的取值手动修改为第一步查询得到的旧值，不要使用DCE自动生成的新值。
  3. 保存DCE配置后，清空TYPO3全站缓存，此时检查后台对应DCE元素的图片字段，旧上传的图片即可正常显示，刷新后也不会出现丢失问题。

注意：操作全程不要执行TYPO3安装工具中「清理废弃文件引用」类的升级向导，也不要执行DCE的配置重置操作，避免旧的关联记录被系统误删。

• 批量处理方案：如果站点涉及的DCE图片字段数量较多，可以直接编写SQL批量更新sys_file_reference表中的fieldname值为新版本的默认生成值，操作逻辑和上述步骤一致，无需逐字段调整配置。

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