PhpStorm中PHP项目路径重复引发404错误的原因与解决方法

可能的原因 #

• 项目的Web资源目录与PhpStorm识别的项目根目录配置冲突，导致路径叠加
• 全局PHP内置服务器的运行配置模板中，文档根或URL模板设置重复了项目路径（比如start）
• 旧项目的.idea配置目录残留了错误的路径设置，新建项目无此问题就是因为没有旧配置干扰

解决步骤 #

1. 修正Web资源目录配置 #

打开File > Project Structure（快捷键Ctrl+Alt+Shift+S）：

• 切换到Modules标签页，选中当前项目模块
• 右侧Web Resource Directory要设置为实际的Web根目录（比如你的start目录），确保不是上级目录+重复路径
• 确认后点击Apply保存

2. 修改全局运行配置模板 #

打开Run > Edit Configurations：

• 点击左上角的Templates展开，选择PHP Built-in Web Server
• 检查Document root：如果这里设置的是项目根目录（而非start目录），运行时会自动拼接文件相对路径，导致start重复。直接选择start作为文档根
• 检查URL字段：如果模板里写了固定的/start，再加上文件相对路径就会重复，改成http://localhost:8000/$FileDirRelativeToDocumentRoot$，让路径基于文档根自动生成
• 点击Apply后，新的运行配置会自动继承这个模板

3. 清理旧配置文件（可选） #

如果上面两步没用，关闭PhpStorm，删除项目根下的.idea目录，重新打开项目。PhpStorm会自动生成全新的配置文件，避免旧设置干扰

4. 验证单个运行配置 #

如果之前修改过单个文件的运行配置，右键文件选择Run 'xxx.php'，检查生成的URL是否正常，确保它继承了修改后的全局模板设置

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