TYPO3 11.5.28 CKEditor保存tt_content时出现InvalidPathException错误求助

问题重现场景 #

使用TYPO3 11.5.28版本，通过CKEditor编辑textpic类型的tt_content记录时，若首行HTML标签（如<h2>）内仅包含单个单词（例如<h2>word</h2>），保存时会抛出以下错误：

TYPO3\CMS\Core\Resource\Exception\InvalidPathException
File /

word

Lorem is not valid (".." and "//" is not allowed in path).

当标签内包含多个单词时（如<h2>word anotherword</h2>），则无此问题。

问题根源 #

该错误源于TYPO3处理textpic内容时，从首行文本提取资源路径/文件名的逻辑存在bug：当首行仅单个单词时，系统错误地将HTML标签与文本内容一同识别为路径字符串，触发资源路径合法性校验失败。

解决方案 #

1. 临时规避方案 #

在单个单词的标题标签内添加非换行空格（ ），示例：

<h2>word&nbsp;</h2>

此方法可绕过错误的路径解析逻辑，实现正常保存。

2. 核心修复方案 #

• 升级TYPO3版本：该bug已在TYPO3 11.5系列后续更新版本中修复，建议升级至11.5.x分支的最新LTS版本（如11.5.35及以上），直接解决底层逻辑问题。
• 排查自定义配置/扩展：若项目存在自定义textpic处理逻辑（如TypoScript配置、第三方扩展），检查是否有从内容中提取文本生成资源路径的代码，调整正则或解析规则，确保仅提取纯文本内容而非带HTML标签的字符串。
• 禁用自动资源命名逻辑：若无需从内容自动生成资源文件名，可在TypoScript中关闭相关配置，示例：

tt_content.textpic {
    20.1.file {
        # 取消从内容自动生成文件名的设置
        name = 
    }
}

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