自定义验证规则必须返回非空字符串才能阻断提交；需在Ajax外层return错误信息，保留async:false，且查重时应传ID排除自身。
lay-verify 自定义规则必须返回字符串才能阻断提交
很多人写完 form.verify 里的 ajax 后发现表单照常提交，根本没拦住——问题几乎都出在「验证函数没返回错误提示字符串」。layui 的验证机制只认函数返回非空字符串（如 "用户名已存在"）才会阻止提交；如果只在 success 里设变量、没在函数末尾 return，就等于没返回，验证通过。
关键点：
-
async: false必须保留（虽然不推荐，但 Layui 验证钩子不支持 Promise 或 async/await） - 错误提示必须写在 Ajax 外层，不能只藏在回调里
- 不要用
layer.msg或alert替代return，它们不影响验证流程
form.verify 中调用 Ajax 查重的典型结构
以下是最简可用的查重验证写法，适配用户名、邮箱、手机号等字段：
form.verify({
username: function(value, item) {
if (!value) return '用户名不能为空';
let msg = '';
$.ajax({
url: '/api/check-username',
type: 'GET',
data: { username: value },
async: false,
success: function(res) {
if (res && res.exists) {
msg = '该用户名已被注册';
}
}
});
return msg; // ← 这一行决定是否拦住提交
}
});
注意：
-
item参数可用来获取当前 DOM 元素，比如读取隐藏的data-id做编辑时排除自身（避免误判重复） - 后端接口建议返回标准 JSON，如
{ "exists": true }，别直接返回布尔值（部分 jQuery 版本会解析异常） - GET 请求注意 URL 编码，
value中含特殊字符时用encodeURIComponent(value)
查重时如何排除当前编辑项（ID 回显场景）
新增表单没问题，但编辑已有记录时，输入原用户名会被判“重复”。必须把当前记录 ID 传给后端做排除判断。
HTML 中加一个隐藏字段或 data 属性：
<input type="text" name="username" lay-verify="username" value="admin"> <input type="hidden" name="id" value="123">
JS 中读取并透传：
username: function(value, item) {
const id = $('input[name="id"]').val();
let msg = '';
$.ajax({
url: '/api/check-username',
data: { username: value, id: id },
async: false,
success: function(res) {
if (res && !res.pass) {
msg = res.message || '用户名已被占用';
}
}
});
return msg;
}
后端逻辑需区分：ID 存在时，查库跳过该 ID 对应记录；ID 为空时，全量查重。
为什么不能用 onblur + layer.msg 做实时提示？
单独监听 blur 发 Ajax 确实能提示，但无法和 Layui 表单提交流程联动——用户可能直接点提交按钮，绕过 blur，导致重复提交失败；或者提示了“已存在”，用户改了内容但没再次 blur，验证状态未更新。
真正可靠的方案只有两种：
- 把查重逻辑塞进
form.verify规则里（推荐，强耦合、必触发） - 在
form.on('submit(...)')里手动发 Ajax 校验，成功后再调用form.submit()（更灵活，但要自己控制 loading 和错误定位）
前者简单直接，后者适合需要组合多个异步校验（如用户名 + 手机号 + 邮箱）的场景。
最易被忽略的一点：所有 Ajax 查重请求都应加防抖或节流，否则快速输入时会发出一堆并发请求，后端响应顺序错乱，导致提示与实际输入不匹配。
