VSCode内置Web服务器调试网络驱动器PHP文件报错问题

问题成因分析 #

映射网络驱动器无法识别的原因 #

Windows系统的网络驱动器映射是用户会话隔离的：你在当前用户的图形界面会话中挂载的Z盘，仅在当前交互式会话中可见。VSCode调用PHP内置服务器时创建的子进程，会话上下文不会继承当前用户的网络驱动器映射，导致PHP解析Z:\路径时找不到对应挂载点，抛出文件不存在错误。
而UNC路径（\\192.168.0.100\htdocs）直接通过SMB协议解析，不依赖本地挂载的盘符，因此可以正常访问。你手动在命令行执行PHP代码能读取Z盘文件，是因为手动启动的命令行属于当前交互式会话，可以读取到Z盘映射，和VSCode启动的PHP子进程上下文不同。

NTFS Junction无法识别的原因 #

你服务器端的htdocs文件夹属于NTFS重解析点的一种（交接点），PHP内置服务器处理跨主机SMB共享中的重解析点时，默认不会跟随重定向：

• 服务器本地访问时，Windows内核会自动处理Junction的重定向逻辑，访问无异常
• 客户端通过SMB访问时，SMB协议默认会将Junction指向的服务器本地路径返回给客户端，客户端拿到的是服务器侧的本地路径（如D:\实际存储路径\htdocs），客户端本地不存在该路径，因此PHP报错无法找到文件。你直接将网络驱动器映射到Junction指向的实际路径时，跳过了重解析点的解析步骤，因此功能恢复正常。

修复方案 #

• 方案1（优先推荐）：在VSCode中直接用UNC路径打开工作区，不使用映射盘符，从根源避免盘符会话隔离和重解析点解析问题
• 方案2（保留映射盘符）：修改launch.json配置，将webRoot和cwd参数硬编码为对应的UNC路径，不使用${workspaceFolder}变量；也可以在runtimeArgs中新增盘符映射命令，确保PHP子进程会话可以识别Z盘
• 方案3（修改服务端配置）：将服务器端Junction指向的实际存储目录直接设置为SMB共享根目录，不要共享包含Junction的上层目录，避免SMB返回重解析点路径给客户端
• 方案4（PHP配置适配）：在php.ini中新增配置open_basedir = "Z:\htdocs;\\192.168.0.100\htdocs;E:\Program Files\VSCode\data\php\pear"，显式授权PHP访问对应路径，开启跨SMB的重解析点跟随能力。

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