TYPO3 v13.4扩展集成异常：wacon-cookie-management无法正常使用

问题整理 #

• 扩展在后端站点定义里无法找到
• 给站点包config.yaml添加依赖后，提示无效Site-Set
• 执行vendor/bin/typo3 site:sets:list未列出该扩展
• 仅能使用部分功能，CSS文件加载失败
• 已执行extension:setup命令激活扩展

排查解决步骤 #

1. 确认扩展的Composer安装有效性 #

先检查扩展是否被正确安装：

• 执行composer show waconcookiemanagement/wacon-cookie-management，若能返回版本、安装路径等信息则安装正常；若提示找不到包，重新执行安装命令：

  composer require waconcookiemanagement/wacon-cookie-management
  

• 查看项目vendor/waconcookiemanagement/wacon-cookie-management目录是否存在，确认扩展文件完整。

2. 修正Site-Set依赖的错误写法 #

TYPO3的Site-Set使用扩展键名而非Composer包名，该扩展的键名为waconcookiemanagement。修改站点包的config.yaml：

dependencies:
  - waconcookiemanagement

修改后执行vendor/bin/typo3 site:sets:list，确认是否能列出该扩展。

3. 强制刷新缓存与站点配置 #

Plesk环境易出现缓存未更新问题，执行以下命令：

# 清除所有缓存
vendor/bin/typo3 cache:flush
# 刷新站点配置
vendor/bin/typo3 site:config:import
# 重新激活扩展
vendor/bin/typo3 extension:setup --extension=waconcookiemanagement

完成后刷新后端页面，查看站点定义中是否出现该扩展的配置选项。

4. 修复CSS加载失败问题 #

CSS加载失败多因静态资源未注册或发布：

• 检查扩展的Configuration/TypoScript/setup.typoscript中是否有静态资源声明，示例：

  page.includeCSS.waconcookiemanagement = EXT:waconcookiemanagement/Resources/Public/Css/main.css
  

• 若未自动加载，手动在模板TypoScript中添加上述代码（替换为实际CSS路径）。
• 执行vendor/bin/typo3 asset:install，同步扩展静态资源到public/typo3conf/ext/目录（TYPO3 v12+通过Asset Manager管理资源）。

5. 检查Plesk文件权限设置 #

Plesk的权限限制可能导致TYPO3无法读取扩展文件：

• 确保vendor/、public/typo3conf/ext/目录的所有者为Web服务器用户（通常为www-data或apache），目录权限设为755，文件权限设为644。
• 在Plesk面板的「文件」->「权限」中调整对应目录权限，避免因权限不足导致资源无法访问。

6. 验证版本兼容性 #

确认安装的Wacon Cookie Management版本支持TYPO3 v13.4：

• 执行composer show waconcookiemanagement/wacon-cookie-management查看版本，若版本过低，安装兼容的最新稳定版：

  composer require waconcookiemanagement/wacon-cookie-management:@stable
  

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