在 Laravel 项目中，我们通常使用 storage/app/public 目录来存储用户上传的文件。为了通过 Web 访问这些文件，Laravel 提供了 php artisan storage:link 命令，用于创建符号链接（Symbolic Link），将 storage/app/public 映射到 public/storage。然而，在实际开发中，可能会遇到图片上传后无法通过 URL 访问的问题。本文将详细分析问题的原因，并提供解决方案。

---

问题描述

在 Laravel 项目中，前端使用 WebUploader 上传图片，图片成功保存到 storage/app/public/images 目录下。然而，当通过 URL 访问图片时，却返回 404 Not Found 错误。例如：

http://10.10.205.19:8080/storage/images/2022/12/EK23gbeyNGwAObdq60kC3N9qVmOAKkylKejWiMEL.png

尽管在服务器上确认文件确实存在，但无法通过浏览器访问。

---

问题原因

经过排查，发现问题的根本原因是 public/storage 符号链接损坏或指向错误。以下是可能导致问题的原因：

1. 符号链接损坏：
   - public/storage 是一个符号链接，指向 storage/app/public。
   - 如果符号链接被意外删除、损坏或指向了错误的位置，就会导致文件无法通过 URL 访问。

2. 文件权限问题：
   - 如果 storage/app/public 目录或文件的权限设置不正确，Web 服务器可能无法读取文件。

3. 服务器配置问题：
   - Nginx 或 Apache 的配置可能不正确，导致无法访问 public/storage 目录。

---

解决方案

1. 重新创建符号链接

如果 public/storage 符号链接损坏或指向错误，可以通过以下步骤修复：

     1. 删除 public/storage 文件夹：

 rm -rf public/storage

     2. 重新创建符号链接：

 php artisan storage:link

      3. 检查符号链接是否正确：

ls -l public/storage

      输出应类似于：

 lrwxrwxrwx 1 user group 20 Jan 1 12:34 public/storage -> ../storage/app/public

 2. 检查文件权限

确保 storage/app/public 目录和文件的权限设置正确，允许 Web 服务器读取文件。

      1. 设置目录权限：

chmod -R 755 storage/app/public

      2. 设置文件所有者（根据 Web 服务器用户调整）：

 sudo chown -R www-data:www-data storage/app/public

3. 检查服务器配置

确保 Nginx 或 Apache 的配置正确，允许访问 public/storage 目录。

Nginx 配置示例

server {
    listen 8080;
    server_name 10.10.205.19;

    root /path/to/your/laravel-project/public;
    index index.php;

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

    location /storage {
        alias /path/to/your/laravel-project/public/storage;
        try_files $uri $uri/ =404;
    }

    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/var/run/php/php8.1-fpm.sock; # 根据你的 PHP 版本调整
    }
}

Apache 配置示例

<VirtualHost *:8080>
    DocumentRoot /path/to/your/laravel-project/public
    ServerName 10.10.205.19

    <Directory /path/to/your/laravel-project/public>
        Options Indexes FollowSymLinks
        AllowOverride All
        Require all granted
    </Directory>

    ErrorLog ${APACHE_LOG_DIR}/error.log
    CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>

4. 清除 Laravel 缓存

有时 Laravel 的缓存可能导致问题，运行以下命令清除缓存：

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

---

 总结

在 Laravel 项目中，图片上传后无法访问的问题通常是由于 public/storage 符号链接损坏或指向错误导致的。通过删除 public/storage 并重新运行 php artisan storage:link，可以修复符号链接的问题。此外，还需要检查文件权限和服务器配置，确保文件可以通过 Web 访问。

为了避免类似问题，建议在部署 Laravel 项目时，将 php artisan storage:link 加入部署脚本，并确保 public/storage 和 storage/app/public 的权限设置正确。

---

预防措施

1. 文档记录：
   - 在项目文档中明确说明 php artisan storage:link 的作用和使用方法。

2. 自动化部署：
   - 在部署脚本中加入 php artisan storage:link，确保每次部署时符号链接都会被正确创建。

3. 权限管理：
   - 确保 public/storage 和 storage/app/public 的权限正确，避免因权限问题导致文件无法访问。

---

希望本文能帮助你解决 Laravel 项目中图片上传后无法访问的问题。如果你有其他问题或建议，欢迎在评论区留言！😊