DDEV环境下TYPO3 v10出现404 Page not found问题求助

• 检查DDEV路径映射与Webroot配置

  • 执行ddev describe查看当前webroot设置，TYPO3 Composer项目的webroot应为public，若配置错误，修改.ddev/config.yaml后执行ddev restart
  • 进入容器验证文件完整性：ddev ssh后执行ls public/，确认index.php、typo3等核心文件存在，若缺失则运行ddev composer install重新拉取依赖

• 校验TYPO3系统配置

  • 查看public/typo3conf/LocalConfiguration.php，确认siteURL与DDEV访问URL（如https://<项目名>.ddev.site/）一致，若不匹配可临时调整
  • 执行ddev typo3cms site:list检查站点配置是否存在，无配置则需重新创建匹配项目路由的站点
  • 运行ddev typo3cms install:fixfolderstructure修复TYPO3目录权限与结构

• 排查DDEV更新后的兼容性

  • 检查.ddev/config.yaml中的nginx_settings是否有冲突规则，可备份后执行ddev config --auto生成默认配置，再重启容器
  • 确认PHP版本兼容：TYPO3 v10支持PHP 7.2-7.4，执行ddev exec php -v查看版本，不符则在config.yaml中设置php_version: "7.4"后重启

• 分析Web服务器日志

  • 查看Nginx错误日志定位具体问题：ddev logs -s nginx，日志会提示文件缺失、权限错误等具体原因，针对性修复

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