lay-search未配对不会发请求，纯前端过滤；启用远程搜索需layui 2.9.16+对象写法，url须完整路径，后端需接收q参数。
lay-search没配对，根本不会发请求
默认只写 lay-search 或 lay-search=""，Layui 做的是纯前端过滤，压根不走网络。用户输“杭州”，页面只是在已有 <option> 里筛一遍，后端完全没感知。
要触发远程搜索，必须用 layui 2.9.16+ 的对象写法：lay-search="{ remote: true, url: '/api/areas' }"。注意三点：
-
url必须是完整路径，不能省略协议或域名（开发时常见写成'/api/areas'就够了，但部署到子路径下可能需补全） - 请求会自动带
q=xxx参数，后端接口得能接收这个字段，别写成keyword或search - 如果用了旧版 Layui（
后端返回格式不对，Layui 拒绝渲染
哪怕接口返回 HTTP 200，只要 JSON 结构不满足要求，Layui 就当失败处理，下拉框空着不动。
必须严格返回这种结构：
{ "code": 0, "msg": "", "data": [ {"value": "1", "title": "杭州市西湖区"}, {"value": "2", "title": "杭州市拱墅区"} ] }
常见错因：
- 把
data写成list、options、result—— Layui 只认data字段 - 用
text/label当键名 —— Layui 只识别value和title，其他字段全丢弃 -
code不是0（比如后端习惯用1表示成功）—— Layui 认为这是错误响应，不解析data
输入带空格或特殊字符，后端没清洗就查库
用户输“ 杭州 ”（前后有空格），前端 URL 编码后是 q=%20%E6%9D%AD%E5%B7%9E%20，如果后端不做 trim()，数据库 LIKE '%杭州%' 就匹配不到。
必须在后端做两件事：
- 对
q参数调用trim()（Java 用StringUtils.trimToEmpty()，Node.js 用req.query.q?.trim() || ''） - 模糊查询时拼接通配符：不是
WHERE name = ?，而是WHERE name LIKE CONCAT('%', ?, '%') - 别依赖前端去空格 —— Layui 不做任何预处理，原样传参
动态加载后没重绘，DOM 更新了但 UI 没反应
远程请求回来、手动清空再插入 <option>，结果下拉框还是老样子？大概率是漏了 form.render("select")。
关键点：
- 必须在新
<option>插入 DOM 后立即调用，不能放在异步回调外层或防抖定时器外面 - 如果 select 在特定 form 容器里，且该容器有
lay-filter="areaForm"，请传第二个参数：form.render("select", "areaForm") - 别用
.html("")清空，某些版本会破坏 Layui 封装结构；改用.empty()或遍历移除
最隐蔽的坑是：你写了 form.render("select")，但父容器没加 class="layui-form" —— Layui 根本扫描不到这个 select，调了也白调。
