Windows10环境Ddev-Pantheon部署出现File not found问题求助

核心问题："File not found." 错误排查 #

1. 确认docroot配置准确性 #

• 打开.ddev/config.yaml，检查docroot字段值，确保指向的目录确实包含index.php等Web入口文件。
• 执行命令验证目录内容：

  ddev exec ls -l /var/www/html/$(grep '^docroot:' .ddev/config.yaml | awk '{print $2}')
  

• 注意Windows路径需使用正斜杠（如docroot: web），禁止使用反斜杠。

2. 查看Web服务器日志定位根源 #

• 执行命令查看Web服务错误日志，日志会明确显示缺失的文件路径：

  ddev logs -s web
  

• 若使用Nginx，检查docroot下的.htaccess规则是否兼容；若使用Apache，确认虚拟主机配置已正确指向docroot。

3. 修复文件权限问题 #

Windows下WSL2环境易出现权限异常，执行以下命令重置权限：

ddev exec chmod -R 755 /var/www/html/$(grep '^docroot:' .ddev/config.yaml | awk '{print $2}')
ddev exec chown -R www-data:www-data /var/www/html/$(grep '^docroot:' .ddev/config.yaml | awk '{print $2}')

4. 重置Ddev环境 #

• 彻底关闭并重启Ddev服务：

  ddev poweroff
  ddev start
  

• 清除PHP OPcache缓存：

  ddev exec php -r "opcache_reset();"
  

额外疑问解答 #

Git仓库克隆位置 #

Ddev对仓库位置无强制要求，常见存放路径：

• Windows本地：C:\Users\<你的用户名>\Projects\<项目名>
• WSL2文件系统：/home/<你的用户名>/Projects/<项目名>（推荐，避免跨系统文件权限/性能问题）

ddev pull pantheon 文件存放路径 #

• 拉取的Git代码：直接存放在Ddev项目根目录（执行ddev start的目录）
• 拉取的数据库：导入到Ddev数据库容器，可通过ddev db export <文件名>.sql导出本地查看
• 拉取的静态资源（如上传文件）：默认存放在项目根目录的files文件夹，或根据Pantheon站点结构存放在docroot下的对应目录（如sites/default/files）

Lando .yml 文件的影响 #

是的，.lando.yml会与Ddev产生冲突（如端口占用、环境变量冲突），直接删除或重命名该文件后执行ddev restart即可避免干扰。

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