Laravel中用户头像存储后无法访问返回404问题求助

Let’s walk through fixing this avatar display problem—you’re already halfway there since the files exist and Storage methods can access them, so it’s probably a tiny configuration or server setup issue.

Common Fixes to Try #

1. Verify the Storage Symbolic Link is Correct #

First, double-check that the public/storage symlink actually points to storage/app/public. Sometimes the php artisan storage:link command fails silently, especially on Windows or if you have permissions issues.

• On Linux/macOS: Run ls -l public/storage in your project root. You should see something like storage -> ../storage/app/public.
• On Windows: Check the public/storage shortcut’s target path—make sure it points to [your-project-path]/storage/app/public.

If the link is missing or incorrect:

1. Delete the existing link (or shortcut): rm public/storage (Linux/mac) or manually delete the Windows shortcut.
2. Recreate it with php artisan storage:link (run this as an administrator on Windows if needed).

2. Confirm Your APP_URL Environment Variable Matches Your Server #

Your generated avatar URLs depend on the APP_URL in your .env file. If your app is running on http://localhost:8080, your .env must have:

APP_URL=http://localhost:8080

Mismatched ports or domains here will generate invalid URLs that return 404s. After updating .env, clear your config cache with:

php artisan config:clear

3. Check Your Web Server’s Root Directory #

Make sure your web server (Apache, Nginx, etc.) is pointing to your project’s public folder as its root directory—not the project’s main root folder.

• For Nginx: Your config should have something like:

  root /var/www/your-project/public;
  

• For Apache: Set DocumentRoot to /path/to/your-project/public.

If the server is pointing to the project root, it will look for storage/... instead of public/storage/..., which doesn’t exist (hence the 404).

4. Test Direct File Access #

Try accessing the file directly via the symlink path to isolate the issue. For example:

http://localhost:8080/storage/avatars/04it83vKYnobT7l8dNXwt1pE0VxiT9L5lQPQ6A1Z.jpeg

If this fails but http://localhost:8080/public/storage/avatars/... works, your server’s root directory is definitely misconfigured.

5. Clear All Caches #

Sometimes old cached configs can cause unexpected behavior. Run these commands to reset everything:

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

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