Laravel 5.4图片404错误求助：本地正常共享主机无法加载图片

我太懂这种本地跑的好好的，一部署到共享主机就掉链子的糟心感了——毕竟你已经耗了5小时排查，肯定急着解决。结合你说的情况，咱们一步步来揪出问题：

1. 重新确认符号链接的有效性 #

共享主机的环境经常和本地不一样，软链接很容易出问题：

• 先检查软链接的绝对路径是否正确：本地的storage/app/public在共享主机上可能是/home/your-username/storage/app/public，而public目录一般是/home/your-username/public_html，所以创建软链接时要写绝对路径：

  ln -s /home/your-username/storage/app/public /home/your-username/public_html/storage
  

• 如果主机禁用了SSH命令，试试用Laravel的Artisan命令创建，但要写绝对路径：

  php /home/your-username/public_html/artisan storage:link
  

• 要是软链接死活创建不了，先手动复制应急：把storage/app/public/avatars里的图片直接复制到public_html/avatars目录，先让图片显示，再慢慢排查软链接问题。

2. 检查Web服务器的静态文件处理规则 #

你提到直接访问图片URL会触发RouteCollection的异常，说明请求被Laravel路由接住了，而没有去读静态文件——这大概率是Apache/Nginx的配置问题：

对于Apache #

• 确认public_html/.htaccess文件存在，并且内容是Laravel默认的规则：

  <IfModule mod_rewrite.c>
      <IfModule mod_negotiation.c>
          Options -MultiViews -Indexes
      </IfModule>
  
      RewriteEngine On
  
      # Handle Authorization Header
      RewriteCond %{HTTP:Authorization} .
      RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]
  
      # Redirect Trailing Slashes If Not A Folder...
      RewriteCond %{REQUEST_FILENAME} !-d
      RewriteCond %{REQUEST_URI} (.+)/$
      RewriteRule ^ %1 [L,R=301]
  
      # Send Requests To Front Controller...
      RewriteCond %{REQUEST_FILENAME} !-d
      RewriteCond %{REQUEST_FILENAME} !-f
      RewriteRule ^ index.php [L]
  </IfModule>
  

• 联系主机商确认是否开启了mod_rewrite模块，很多共享主机默认没开这个。

对于Nginx #

• 确保主机的Nginx配置里有处理静态文件的规则：

  location / {
      try_files $uri $uri/ /index.php?$query_string;
  }
  

  这条规则会先找静态文件，找不到才交给Laravel路由，没有的话所有请求都会被路由捕获，导致图片404。

3. 核对文件权限和Web用户访问权 #

共享主机的权限限制很严格，别忽略这点：

• 把storage/app/public/avatars和public_html/storage（软链接或实际目录）的权限设为755，图片文件设为644。
• 确认Web服务器的用户（比如apache、www-data，有些主机用你的用户名）有读取这些文件的权限，如果不确定，联系主机商帮忙核对。

4. 检查Laravel的文件系统配置 #

• 打开config/filesystems.php，确认public磁盘的配置：

  'public' => [
      'driver' => 'local',
      'root' => storage_path('app/public'),
      'url' => env('APP_URL').'/storage',
      'visibility' => 'public',
  ],
  

• 打开.env文件，确保APP_URL是你共享主机的完整域名，比如https://your-domain.com，不要加末尾的斜杠。
• 生成图片URL时，一定要用Laravel的辅助函数：asset('storage/avatars/your-image.jpg')或者Storage::url('avatars/your-image.jpg')，别手动拼路径，容易出错。

5. 清理深层缓存 #

除了你已经做的操作，再试试这些：

• 清除路由缓存：php artisan route:clear
• 如果主机用了OPcache，联系主机商帮忙清除，或者等个10-15分钟让缓存自动过期。

快速测试小技巧 #

如果以上都没解决，创建一个test.php文件放在public_html目录里，内容如下：

<?php
// 替换成你实际的图片路径
$imagePath = storage_path('app/public/avatars/test.jpg');
if (file_exists($imagePath)) {
    header('Content-Type: image/jpeg');
    echo file_get_contents($imagePath);
} else {
    echo "文件不存在或无法读取";
}
?>

访问这个文件，如果能显示图片，说明是Web服务器配置的问题；如果显示“文件不存在”，说明是路径或权限问题。

内容的提问来源于stack exchange，提问作者Yeasir Arafat Majumder