Laravel后台上传图片正常 public移至根目录后前台图片不显示

DevOps 小满

2026-8-27

问题成因

index.php存在错误冗余代码：你把仅用于PHP本地内置开发服务器的server.php里的静态判断逻辑，错误复制到了生产环境使用的根目录index.php中。这段逻辑的运行依赖PHP内置服务器的特殊约定——路由脚本返回false时服务器会直接返回对应静态文件，但在Apache环境下，PHP执行到return false只会直接终止、返回空响应，完全不会输出图片等静态资源内容。
Laravel公共路径未同步修改：移动原public目录文件到根目录后，框架默认的公共目录路径仍指向项目根目录下的public子文件夹，导致后台上传的文件实际存入根目录/public/user-uploads/，而Web站点的根目录是项目根目录，请求路径和文件实际存储位置不匹配。
冗余代码里的require_once __DIR__.'/index.php'因为带了_once后缀，不会触发无限递归，所以动态页面、后台功能可以正常运行，只有静态资源请求会被拦截，表现为其他功能正常、仅图片无法加载。

修复方案

修正根目录index.php代码
删除所有从server.php复制的冗余逻辑，同时在框架启动实例后注册新的公共路径，替换原有的public目录配置。修正后的完整index.php代码如下：

<?php

use Illuminate\Contracts\Http\Kernel;
use Illuminate\Http\Request;

if (version_compare(PHP_VERSION, '7.4.0') < 0){
    $GLOBALS["error_type"] = "php-version";
    include('error_install.php');
    exit(1);
}

define('LARAVEL_START', microtime(true));

if (file_exists(__DIR__.'/storage/framework/maintenance.php')) {
    require __DIR__.'/storage/framework/maintenance.php';
}

require __DIR__.'/vendor/autoload.php';

$app = require_once __DIR__.'/bootstrap/app.php';
// 把公共路径绑定为当前根目录，替代原public目录
$app->instance('path.public', __DIR__);

$kernel = $app->make(Kernel::class);

$response = tap($kernel->handle(
    $request = Request::capture()
))->send();

$kernel->terminate($request, $response);

迁移已上传的存量文件
把原本存放在根目录/public/user-uploads/下的所有子文件夹（logo、头像、通用图片等）和文件，整体移动到根目录/user-uploads/路径下，移动完成后可以删除空的public目录避免后续混淆。
校验目录权限
确保user-uploads及其所有子目录权限为755，目录内文件权限为644，保证Web服务进程有读取权限，避免出现403权限错误。
清理框架缓存
通过虚拟主机SSH终端执行以下命令清理缓存，没有SSH的可以通过面板Laravel管理工具、或临时PHP脚本执行对应artisan命令：

php artisan config:clear
php artisan route:clear
php artisan view:clear
php artisan cache:clear

修复完成后，直接在浏览器访问单张图片的完整URL验证是否可以正常打开，验证通过后刷新前台页面即可正常加载所有上传图片。当前你使用的.htaccess规则没有问题，不需要修改；server.php仅用于本地开发调试，生产环境不会调用，无需调整。

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