图片404主因是路径错误，包括相对路径漏写./../、php变量为空导致路径异常、绝对路径缺域名、linux大小写敏感致文件名不匹配，需用realpath()和file_exists()验证服务器真实路径。
检查 src 属性生成的 URL 是否真实可访问
浏览器里右键图片 → “检查元素”，看 src 的完整地址。直接复制进新标签页打开，如果返回 404，说明路径根本没对应到文件。常见错误包括：
• 漏写 ./ 或 ../，比如本该是 ./images/logo.png 却写成 images/logo.png（相对路径起点取决于当前 HTML 文件位置）
• PHP 动态拼接时变量为空或含非法字符，例如 $path = $dir . '/' . $filename; 中 $dir 未定义，导致变成 //logo.png
• 使用了绝对路径但没带域名，如 /assets/img/test.jpg 在本地双击 HTML 打开会失败（协议为 file://），必须走 Web 服务器（http:// 或 https://）
确认服务器实际文件路径与大小写完全匹配
Linux 服务器区分大小写，Windows 和 macOS（默认）不区分——但部署到生产环境（通常是 Linux）就容易出问题。比如：
• PHP 输出 src="img/Logo.PNG"，但实际文件名是 logo.png → 404
• 路径中夹杂大写目录名，如 /Images/ 对应服务器上的 /images/ → 404
• Git 提交时大小写变更未被识别（尤其从 Windows 开发推到 Linux 服务器），可用 ls -la img/ 在服务器上直接查看真实文件名
用 realpath() 和 file_exists() 验证 PHP 后端路径逻辑
别只靠肉眼拼字符串，加两行调试代码立刻定位问题：
• echo realpath($full_path); 看解析后的绝对路径是否合理
• var_dump(file_exists($full_path)); 返回 false 就说明文件确实不存在或权限不足
• 注意：PHP 的 file_exists() 检查的是服务器文件系统路径，不是 URL 路径。例如 /var/www/html/assets/img/test.jpg 是合法的文件路径，而 https://site.com/assets/img/test.jpg 一定返回 false
避免依赖当前工作目录，统一用 __DIR__ 构建路径
PHP 脚本执行时的当前目录（getcwd()）可能因调用方式不同而变化，极易导致相对路径失效。更可靠的方式是：
• 用 __DIR__ 获取当前 PHP 文件所在目录，再向上/向下拼接，例如：__DIR__ . '/../public/images/' . $name;
• 图片资源尽量放在 Web 可访问目录（如 public/ 或 web/）下，PHP 后端路径和前端 src 路径保持映射清晰
• 如果用 URL 输出图片（比如通过 image.php?file=xxx），确保该脚本对文件路径做了白名单校验和 realpath() 归一化，防止目录穿越攻击
立即学习“PHP免费学习笔记（深入）”；
最常被忽略的一点：开发时在 Windows 下一切正常，一上 Linux 就 404，十有八九是大小写或路径分隔符（\ vs /）惹的祸。上线前务必在目标环境跑一次 file_exists() 校验。
