Eclipse内置PHP服务器路径错误，生成链接异常如何解决？

软件
Windows 10
XAMPP (Apache、PHPMyadmin、Filezilla、openssl等)
Eclipse版本: 2024-03 (4.31.0)
PHP版本 8.2.12
XDEBUG 3.3.2
项目路径: G:xampp\htdocs\api\project
PHP内置服务器路径: https://localhost
项目路径设置:
项目基础路径: api/project
对应地址: https://localhost/api/project

服务器XML配置：

<?xml version="1.0" encoding="UTF-8"?>
<Server>
    <Port name="HTTP/1.1" protocol="HTTP">8429</Port>
    <PathMapping local="https://localhost/api/project" module="project" remote="G:\xampp\htdocs\api\project"/>
</Server>

• 使用「Run on server」运行时无法正常工作：浏览器提示资源未找到，控制台显示GET /project/login.php返回404；
• 「Run as - CLI application」和「Run as - web application」可正常运行；
• 直接访问localhost:8429、localhost:8429/api/project均提示未找到；
• 测试发现访问http://localhost:8429/login.php正常，但Eclipse生成的链接多了/project前缀，需修正该问题。

1. 修正服务器XML路径映射 #

当前PathMapping配置存在错误，local字段不应填完整URL，且映射逻辑与实际访问路径不匹配。修改为以下内容：

<?xml version="1.0" encoding="UTF-8"?>
<Server>
    <Port name="HTTP/1.1" protocol="HTTP">8429</Port>
    <PathMapping local="/" module="project" remote="G:\xampp\htdocs\api\project"/>
</Server>

将local设为/后，项目根目录会直接对应服务器根路径，访问localhost:8429/login.php时，会直接映射到G:\xampp\htdocs\api\project\login.php，和你测试正常的路径逻辑一致。

2. 调整Eclipse项目部署上下文根 #

右键项目 → 选择「Properties」→ 进入「Web Project Settings」页面，将「Context root」修改为/（原配置的api/project或project是导致链接带前缀的核心原因），保存设置后重新部署项目到服务器。

3. 验证修复效果 #

重启Eclipse内置服务器，再次使用「Run on server」运行项目，此时生成的链接会是http://localhost:8429/login.php，不再带有/project前缀，访问即可正常加载资源。

额外检查点 #

• 确认XAMPP的Apache端口（默认80）与Eclipse内置服务器的8429端口无冲突；
• 核实login.php确实存在于G:\xampp\htdocs\api\project目录下，文件路径无拼写错误。

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