安装TYPO3 12.4遇报错：typo3cms install:fixfolderstructure返回错误码1

• 检查文件系统权限
  确保web服务器运行用户（如www-data、apache）对TYPO3核心目录拥有读写权限，重点关注var/、public/typo3conf/、fileadmin/这几个目录。可通过以下命令调整权限（根据服务器环境替换用户组）：

  chown -R www-data:www-data ./var ./public/typo3conf ./fileadmin
  chmod -R 775 ./var ./public/typo3conf ./fileadmin
  

• 手动执行修复脚本
  跳过Composer自动触发的流程，直接手动运行修复命令，查看具体错误输出以定位问题：

  ./vendor/bin/typo3cms install:fixfolderstructure
  

• 临时禁用自动脚本触发
  若暂时不需要自动修复文件夹结构，可修改composer.json的scripts部分，移除或注释post-autoload-dump中的@typo3-cms-scripts，然后执行：

  composer dump-autoload
  

  完成后再手动处理文件夹结构配置。

• 重新验证安装包完整性
  重新下载完整的TYPO3安装包，避免文件缺失或损坏：

  composer install --no-scripts --prefer-dist
  

  之后再手动运行修复脚本及后续安装步骤。

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