livewire 组件必须由 laravel 框架自动实例化，继承 livewire\component，通过 @livewire 调用；表单需用 wire:submit.prevent 和 wire:model；调试应优先检查 x-livewire 请求是否返回合法 json。
Livewire 不是“配个 JS 库就能用”的东西，它依赖 Laravel 的请求生命周期和组件挂载机制。没跑通 mount()、表单不更新、点击无反应——这些问题几乎都卡在「组件没被正确接入」这一步，而不是逻辑写错了。
组件类必须继承 Livewire\Component，且不能手动 new
常见错误是把 Livewire 当成普通 PHP 类来用：在控制器里 new MyComponent()，或者在 Blade 里 echo (new MyComponent)->render()。Livewire 组件必须由框架自动实例化，否则 mount()、render()、属性同步全失效。
- 确认类定义第一行是
class MyComponent extends \Livewire\Component - Blade 中必须用
@livewire('my-component')或<my-component></my-component>声明，不能用@include或@extends - 如果组件在子命名空间（如
App\Http\Livewire\Admin\Dashboard），注册时别写完整路径，除非你显式绑定了别名：Livewire::component('admin.dashboard', Dashboard::class)
wire:submit.prevent 和 wire:model 是表单响应的唯二关键
Livewire 表单不是靠 JS 提交，而是靠它拦截原生提交事件并接管整个流程。漏掉 .prevent 或字段没绑 wire:model，就会退化成传统页面跳转。
- 表单标签加
wire:submit.prevent="save"，对应组件里必须有public function save() - 每个要同步的字段必须带
wire:model="title"，且$title必须是组件里的 public 属性 - 避免在
save()里return view()—— Livewire 要的是副作用（改属性、存 DB），它自己负责重渲染 - 如果提交后页面刷新或跳转，先检查 Network 面板里有没有 X-Livewire 请求；没有，说明
.prevent没生效（拼错成preven、漏点号、或被其他 JS 劫持）
调试失败时，优先看 X-Livewire 响应体是不是 JSON
Livewire 前端靠解析 JSON 响应来更新 DOM。一旦后端返回 HTML、空内容、或抛了未捕获异常，前端就静默失败——看起来像“点了没反应”，实际是 JS 解析崩溃后降级为原生提交。
- 打开浏览器 Network 面板，筛选
X-Livewire请求，点开响应体：正常应是纯 JSON（含"effects","html"字段） - 如果不是 JSON，常见原因：
dd()或die在中间件/组件方法中提前终止；mount()或render()抛出异常；布局文件漏了@livewireScripts或放错位置（必须在
