PHP项目本地路径运行正常 部署到服务器后include引入文件报错如何解决

1. 打印实际路径验证目录结构 #

在add-product.php头部加入临时调试代码，确认服务器实际路径与预期是否一致，用完后及时删除调试代码：

echo "当前文件所在目录：" . __DIR__ . "<br>";
$targetPath = __DIR__ . "/partial/ConnectQuery.php";
echo "尝试引入的目标路径：" . $targetPath . "<br>";
echo "当前目录下的所有文件/文件夹：<pre>";
print_r(scandir(__DIR__));
echo "</pre>";

运行后即可看到public_html目录下是否存在partial文件夹，以及拼接后的路径是否和报错信息一致。

2. 检查文件名大小写一致性 #

Windows环境下的WAMP不区分文件名大小写，但服务器通常为Linux系统，严格区分大小写。需确认：

• partial文件夹的名称大小写是否和代码中拼写完全一致
• ConnectQuery.php的文件名大小写是否和代码中拼写完全一致，避免出现本地用connectquery.php、服务器上传后名称不匹配的问题。

3. 验证文件/文件夹权限 #

即使文件路径正确，权限不足也会导致读取失败：

• partial文件夹权限需设置为755
• ConnectQuery.php文件权限需设置为644
  不要设置为777权限，存在安全隐患。

4. 排查服务器节点/文件同步问题 #

你提供的两条报错路径分别对应ssd3/17657728和ssd4/17661729两个完全不同的存储节点，若你使用的是负载均衡集群或免费虚拟主机，可能存在以下问题：

• 仅在其中一台节点服务器上上传了文件，另一台节点没有同步
• 虚拟主机商更换了存储节点，旧节点的文件未同步到新节点
  可联系你的服务商确认账号对应的实际根目录路径，确认文件是否上传到正确位置。

5. 备选方案：相对路径临时验证 #

若上述步骤排查后仍未解决，可以临时替换为相对路径测试：

include "./partial/ConnectQuery.php";

但长期使用更推荐绝对路径方案，避免路径解析混乱。

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