livewire 中分页必须用 withpagination trait 并在 render() 中调用 paginate()，不可将 paginator 赋给 public 属性；搜索时需在 updatingsearch() 中调 resetpage()；自定义分页模板须用 wire:click 替代 href；外部 api 分页需手动构造 lengthawarepaginator；页码需通过 $querystring 持久化。
不能直接把 Paginator 实例赋给 public 属性，否则会抛出 Livewire\Exceptions\PublicPropertyTypeNotAllowedException —— 这是 Livewire 的硬性限制，不是 bug，必须绕过。
用 WithPagination trait + render() 内查询是最稳的写法
很多人一上来就在 mount() 里调 Post::paginate() 并赋值给 $posts，结果直接报错。Livewire 不允许 public 属性是 Paginator 类型（哪怕它看起来像数组）。正确做法是：不声明 $posts 为 public 属性，也不在 mount() 中初始化它，而是在 render() 里查、在 view() 里传。
- 组件类里只
use WithPagination，不定义public $posts -
render()方法内执行Post::where(...)->paginate(10)，然后用compact('posts')或数组键传入视图 - 视图中直接用
$posts->links()，分页链接能正常响应点击并刷新 - 如果需要搜索过滤，
updatingSearch()里调$this->resetPage()，否则用户在第 3 页搜完可能看到空结果
resetPage() 必须配 updating 钩子，否则搜索后页码不归零
常见错误是只在搜索逻辑里改 $this->search，但没重置分页器状态。比如用户当前在第 5 页，输入关键词后结果只剩 2 页，但页面仍显示第 5 页的空白数据 —— 因为 Paginator 还在请求 offset=40。
- 必须用
updatingSearch()或updatingFilter()这类生命周期钩子，不能只在普通方法里调resetPage() - 如果多个字段触发重置（比如
$search和$status），每个都要单独写updatingXxx()方法 -
resetPage()只影响当前分页器，不会清空其他public属性，放心用
自定义分页视图时，wire:click 替代 href 是关键
用 $posts->links('custom-pagination') 或重写 paginationView() 后，如果模板里还用原生 <a href="?page=2"></a>，点击会整页刷新，Livewire 的无刷新特性就失效了。
- 自定义 Blade 分页模板中，所有翻页链接必须用
wire:click="$set('page', 2)"或wire:click="nextPage"等 Livewire 指令 - 不要手动拼
?page=查询参数，Livewire 会自动管理 URL 和历史记录 - 若用了
WithPagination，nextPage()、previousPage()、gotoPage($n)这些方法已内置，直接调用即可
HTTP 外部 API 分页要自己实现，paginate() 不适用
当数据来自 Http::get() 或第三方接口（如 json_decode($response)），Laravel 的 paginate() 方法无法直接使用 —— 它只支持 Eloquent 和 Query Builder。
- 得手动切数组：
array_slice($data, ($page - 1) * $perPage, $perPage)，再包装成LengthAwarePaginator实例 - 注意：构造
LengthAwarePaginator时，第三个参数必须是总条数（需额外请求或从 API 响应头/元数据中提取） - 别把整个原始 JSON 数组塞进 public 属性，依然会触发类型异常；还是走
render()传参路线
最易忽略的一点：分页器的状态（当前页、每页数）默认不持久化到 URL，如果用户刷新页面，会回到第 1 页。要用 WithPagination 的 queryString 特性显式声明，比如 protected $queryString = ['page' => ['except' => 1]]，否则前端同学提的“刷新丢失页码”问题永远修不完。
