Laravel 12 + Livewire 本地（Laragon）文件上传突然失效问题求助

遇到这种前一天正常、第二天突然罢工的问题确实闹心，我帮你梳理几个常见的排查方向和解决方案，你可以一步步尝试：

一、优先排查Livewire前端依赖与缓存问题 #

Livewire的文件上传完全依赖它的前端JS逻辑，这是最容易出问题的点：

• 硬刷新浏览器+清除缓存：按Ctrl+Shift+R强制刷新页面，有时候浏览器缓存的旧版Livewire JS会导致绑定失效。
• 清除Laravel与Livewire缓存：在终端执行以下命令，避免视图或组件缓存导致的异常：

  php artisan view:clear
  php artisan livewire:clear
  php artisan cache:clear
  

• 确认Livewire资源是否正确引入：检查你的create-donasi.blade.php或它的父模板（比如layouts/app.blade.php）里，是否正确添加了@livewireStyles和@livewireScripts，而且要放在正确的位置（Styles在head标签内，Scripts在body末尾）。

二、检查表单与HTML结构问题 #

• 避免嵌套表单：确认你的livewire.create-donasi视图的父级页面里，有没有已经存在一个<form>标签？嵌套表单会导致浏览器无法正确提交文件数据，这是很容易忽略的细节。
• 临时测试enctype属性：虽然Livewire会自动处理文件上传的编码类型，但可以手动给表单加上enctype="multipart/form-data"试试，特殊场景下能解决意外的提交问题：

  <form wire:submit.prevent="submit" enctype="multipart/form-data" class="space-y-6">
  

三、检查PHP上传配置（Laragon环境） #

虽然之前正常，但可能Laragon的PHP配置被意外修改：

1. 右键Laragon托盘图标，选择PHP -> php.ini打开配置文件。
2. 找到以下两个配置项，确保它们的值大于你设置的5M限制：

   upload_max_filesize = 10M
   post_max_size = 12M
   

3. 修改后重启Laragon的Apache/Nginx服务（右键托盘->Restart All）。

四、检查Livewire临时文件目录权限 #

Livewire会先把上传的文件存在临时目录，这个目录出问题会导致文件无法传递到后端：

• 确认storage/app/livewire-tmp目录是否存在，如果不存在手动创建它。
• 检查该目录的写入权限：Windows下可以右键目录->属性->安全，确保当前用户有读写权限（Laragon默认会配置，但有时候意外会丢失）。

五、用最小化案例测试与调试 #

• 添加实时调试钩子：在你的CreateDonasi组件里加一个updatedImage方法，看看Livewire是否能接收到文件的变化：

  public function updatedImage($file) {
      dd('文件已接收：', $file);
  }
  

  选完文件后如果没有弹出调试信息，说明前端的wire:model="image"完全没生效，问题肯定在前端JS或绑定上；如果有输出，说明后端能接收到，再排查后续的存储逻辑。
• 创建极简测试组件：新建一个只有文件上传的Livewire组件，比如TestUpload，代码和视图都最简，测试是否能正常上传。如果这个组件能工作，说明你的CreateDonasi组件或视图里有其他冲突（比如引入的第三方JS和Livewire事件冲突）。

六、浏览器开发者工具排查 #

打开浏览器F12开发者工具，切换到Network标签：

• 选完文件后，看有没有livewire/upload-file的请求，状态是否为200；
• 提交表单时，看livewire/message请求的Form Data里是否包含image文件；
• 如果请求里完全没有文件数据，100%是前端绑定或JS加载问题；如果有文件但后端没处理，再看后端日志（storage/logs/laravel.log）有没有隐藏的错误。

内容来源于stack exchange