DDEV环境下TYPO3 v11.5加载CSS文件路径错误问题求助

• 检查TYPO3站点根路径与Base URL配置
  进入TYPO3后台站点管理，确认对应站点的：

  • 根页面（Root Page）设置是否正确，未误将sternwarte-mydomain作为路径前缀关联
  • Base URL配置为https://mydomain.ddev.site/，而非包含子路径的格式

• 排查TypoScript资源引用逻辑
  检查加载CSS的TypoScript片段：

  • 确认是否错误拼接了sternwarte-mydomain/前缀，比如错误写法：

    page.includeCSS.mybootstrap = sternwarte-mydomain/fileadmin/templates/assets/css/mybootstrap2.css
    

  • 应使用基于站点根的路径：

    page.includeCSS.mybootstrap = fileadmin/templates/assets/css/mybootstrap2.css
    

  • 检查是否存在环境条件的TypoScript配置，确认DDEV环境未加载错误的路径规则

• 验证DDEV项目配置
  查看.ddev/config.yaml文件：

  • 确认name、http_port等核心配置正确，无额外路由规则导致路径前缀添加
  • 检查additional_hostnames/additional_fqdns设置，排除域名冲突引发的解析异常

• 清理TYPO3全量缓存

  • 后台执行「Flush All Caches」，或通过DDEV命令行执行：

    ddev typo3 cache:flush
    

  确保配置变更完全生效

• 检查页面模板硬编码路径
  核查fileadmin/templates/下的HTML模板文件，确认是否硬编码了sternwarte-mydomain/前缀，生产环境可能通过服务器重写隐藏该前缀，但DDEV环境无对应规则

• 验证.htaccess重写规则
  检查项目根目录.htaccess，确认是否存在移除sternwarte-mydomain/的重写规则，DDEV环境需同步相同规则，或修正规则适配本地环境

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