Mac上新Drupal 10 DDEV项目启动失败求助

排查与修复步骤 #

1. 检查Docker文件共享权限 #

• 打开Docker Desktop偏好设置，进入Resources > File Sharing
• 确认/Users/me/Sites（或上级目录/Users/me）已加入共享列表并勾选
• 点击Apply & Restart重启Docker，之后重新执行ddev start

2. 修复目录权限 #

Mac的文件权限限制可能导致Docker无法访问目标目录，执行以下命令：

chmod -R 755 ~/Users/me/Sites/sandbox
chown -R $(whoami):staff ~/Users/me/Sites/sandbox

完成后再次尝试ddev start

3. 重置DDEV项目配置 #

若项目配置文件存在损坏，强制重新生成配置：

ddev config --force

配置完成后执行ddev start

4. 重启Docker守护进程 #

通过Docker Desktop重启，或用命令行操作：

osascript -e 'quit app "Docker"'
# 等待3-5秒后手动打开Docker，再执行
ddev start

5. 验证目录路径与存在性 #

确认当前所在目录为项目根目录，并检查.ddev目录状态：

pwd
ls -la .ddev

确保输出的路径与报错中的/host_mnt/Users/me/Sites/sandbox/.ddev完全一致，且.ddev目录确实存在

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