如何在TYPO3 9.5中导出包含文件引用的页面？

问题本质 #

TYPO3默认导出工具仅导出数据库记录，内容元素中的图片通过sys_file表的UID关联，XML文件仅存储该UID值。新服务器上sys_file表的UID与原服务器不一致，即便图片文件放在同一目录，数据库中无对应文件元数据记录，内容元素仍无法识别图片。

正确操作步骤 #

1. 导出时包含文件关联数据表 #

导出XML时，除页面、内容元素相关表外，必须勾选以下文件相关表：

• sys_file：存储文件路径、哈希等核心元数据
• sys_file_reference：维护内容元素与文件的关联关系
• sys_file_metadata：存储文件标题、描述等附加信息
  勾选这些表后，XML会包含完整的文件关联记录，导入时能建立正确的UID映射。

2. 完整迁移图片文件 #

将原服务器fileadmin目录下的所有图片（保持原有目录结构）复制到新服务器的fileadmin对应位置。TYPO3依赖文件的目录结构和哈希值识别文件，完整复制可避免路径不匹配问题。

3. 导入时的文件匹配逻辑 #

导入XML前，确保新服务器sys_file表无重复文件记录：

• 若新服务器已有同名文件，TYPO3会通过文件哈希自动匹配
• 若无对应文件，会根据XML中的元数据创建新的sys_file记录，并关联到复制过来的物理文件

补救方案（已导出不含文件表的XML） #

如果已导出缺少文件表的XML，可按以下步骤补救：

• 在原服务器单独导出sys_file、sys_file_reference、sys_file_metadata三个表的XML
• 先将这三个文件表的XML导入新服务器
• 复制原服务器图片文件到新服务器对应目录
• 最后导入之前的页面XML

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