Laravel 5.8图片上传失败，求排查方向及遗漏配置点

嘿，我来帮你梳理下可能的问题点，你遇到的这个场景我之前也踩过不少坑，咱们一步步排查：

1. 先检查PHP的post_max_size配置 #

你已经改了upload_max_filesize，但post_max_size是整个POST请求的总大小限制，它必须大于等于upload_max_filesize，否则即使单文件没超，整个请求也会被拦截。你可以通过phpinfo()查看当前的post_max_size值，建议设为和upload_max_filesize一致或更大（比如20M），改完后记得重启PHP-FPM或Web服务器（Apache/Nginx）。

2. 修复文件名生成的错误 #

你的控制器里这段代码有明显问题：

$filename = $file . '.' . $ext;

$file是UploadedFile对象，直接转成字符串会得到类似Illuminate\Http\UploadedFile@xxxx的无效文件名，这会直接导致存储失败。你可以改成生成唯一且合法的文件名，比如：

// 用原文件名（注意可能存在重复或特殊字符问题）
$filename = pathinfo($file->getClientOriginalName(), PATHINFO_FILENAME) . '.' . $ext;
// 或者生成唯一随机文件名（更推荐，避免冲突）
$filename = \Illuminate\Support\Str::random(12) . '.' . $ext;

3. 确认存储路径的权限与软链接 #

你用了Storage::disk('public')，对应的物理路径是storage/app/public，需要确保：

• 执行过php artisan storage:link命令，把storage/app/public软链接到public/storage，这样前端才能访问到上传的文件；
• storage目录和public/storage目录的权限正确，Web服务器用户（比如www-data）需要有读写权限，你可以用命令设置：

chown -R www-data:www-data storage public/storage
chmod -R 755 storage public/storage

4. 检查服务器的错误日志（非Laravel日志） #

Laravel日志没报错，可能是错误发生在Laravel处理请求之前，比如：

• PHP的临时上传目录（upload_tmp_dir）权限不足，导致文件无法临时存储；
• Nginx/Apache的上传限制，比如Nginx的client_max_body_size配置，要是这个值比PHP的限制小，也会直接拦截请求。
  你可以查看Web服务器的错误日志（比如Nginx的/var/log/nginx/error.log，Apache的/var/log/apache2/error.log），里面可能会有更详细的错误信息。

5. 确认表单包含CSRF令牌 #

你的表单代码里没看到CSRF令牌，Laravel默认会验证所有POST请求的CSRF令牌，要是缺失的话，请求会被拒绝（状态码419）。你需要在表单里添加：

@csrf

或者手动添加隐藏域：

<input type="hidden" name="_token" value="{{ csrf_token() }}">

可以打开浏览器开发者工具的Network面板，查看请求的状态码和响应内容，确认是不是CSRF的问题。

6. 测试小文件上传&捕获验证错误 #

• 先上传一个极小的图片（比如100KB以内），如果能成功，说明还是文件大小相关的配置没生效；
• 在控制器里捕获验证异常，看看是不是验证没通过但没提示：

try {
    $this->validate($request, [
        'image' => 'required|image|mimes:png,jpg,jpeg', // 加上jpeg更稳妥，避免格式识别问题
    ]);
} catch (\Illuminate\Validation\ValidationException $e) {
    dd($e->errors()); // 打印具体的验证错误
}

比如用户上传的是jpeg格式的图片，但你的规则只写了jpg，就会触发验证失败。

7. 确认PHP配置是否真正生效 #

有时候改了php.ini但没重启服务，配置不会生效。你可以在控制器里输出phpinfo()，查看当前的upload_max_filesize和post_max_size是不是你设置的20MB，确保配置已经生效。

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