Laravel生产服务器部署后存储目录访问错误的解决方法

嘿，这个问题我之前帮朋友排查过类似的，核心是Laravel的public_path()指向和你服务器的部署结构不匹配导致的，咱们一步步来调整：

先搞清楚问题根源 #

你提到去掉public_path()时系统能正常读取图片并创建目录，说明网站的根目录已经指向了Laravel的public文件夹（比如Nginx/Apache配置里把网站根目录设为了public），但public_path()却指向了Laravel应用根目录下的public文件夹（也就是在应用目录里新建public/images/users），这说明Laravel默认的public_path()配置和你实际的服务器部署路径不匹配。

具体解决方案 #

1. 手动自定义public_path()指向 #

Laravel允许我们在bootstrap/app.php里手动绑定正确的public路径，这样public_path()就能返回服务器上实际的public目录地址了：
打开bootstrap/app.php，在返回$app的代码之前添加以下代码：

// 方式一：基于项目相对路径（如果你的public目录在Laravel应用的上级目录，比如应用在/var/www/laravel，public在/var/www/html）
$app->bind('path.public', function() {
    return realpath(__DIR__ . '/../../html'); // 根据你的实际路径调整层级
});

// 方式二：直接写服务器绝对路径（更稳妥，比如你的public目录是/var/www/html）
// $app->bind('path.public', function() {
//     return '/var/www/html';
// });

2. 验证路径是否正确 #

修改后，你可以在控制器里临时加一行代码测试：

dd(public_path());

访问对应的页面，看看输出的路径是不是服务器上实际存放public文件的目录，确认正确后再去掉测试代码。

3. 确保目录权限正确 #

不管用哪种路径，都要确保images/users目录（或者要创建的目录）有web服务器用户的写入权限，比如：

# 给目录设置权限
chmod -R 755 /path/to/your/public/images
# 或者把目录所有者改为web服务器用户（比如www-data）
chown -R www-data:www-data /path/to/your/public/images

4. 调整代码中的路径 #

确认public_path()指向正确后，你的代码$userDir = public_path().'/images/users/'就能正确指向public目录下的images/users文件夹了，不会再在Laravel应用目录下新建public文件夹。

补充说明 #

为什么去掉public_path()能正常工作？因为此时用的是相对网站根目录的路径，而你的网站根目录已经是Laravel的public文件夹，所以直接写'/images/users/'就会指向public/images/users，而public_path()如果配置错误，就会拼接错误的根路径导致问题。

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