该错误本质是向原生input元素value属性赋了非字符串值(如null、undefined、对象等),浏览器原生报错;需统一用String()或(v||'')确保值为字符串,form.val()也不自动容错,应在数据进入视图前清洗。

layui 中 input 元素报 Failed to set the 'value' property on 'HTMLInputElement': The provided value is not a valid string.
这个错误本质是:你试图给一个原生 <input type="text">(或类似)元素的 value 属性赋了一个非字符串值,比如 null、undefined、对象、数组或数字(未显式转字符串)。Layui 本身不拦截这类赋值,它只是帮你找 DOM 或绑定事件,真正触发报错的是浏览器原生行为。
常见于以下场景:
- 用
form.val()设置表单时,传入的字段值是undefined或后端返回的null - 手动操作 DOM:
document.getElementById('xxx').value = data.id,而data.id是null或0(某些老版本 Chrome 对0也敏感) - 使用
layui.form().val()(旧写法)或form.val('filter', {key: val})时,val是非字符串类型
解决办法很简单:确保所有塞进 value 的值都是字符串。
推荐做法:
立即学习“前端免费学习笔记(深入)”;
- 统一用
String(x)或(x || '')做兜底,尤其处理可能为null/undefined的字段 - 避免直接操作原生
.value,优先走form.val('filter', obj)—— 它内部会做基础类型转换,但依然不保你传{name: null}不出错 - 后端返回数据后,提前清洗:用
JSON.parse(JSON.stringify(data))不能解决,要用遍历 +String()或?? ''
为什么 form.val() 有时也报错?
form.val('demo', {username: user.name, age: user.age}) 看似安全,但只要 user.name 是 undefined 或 null,Layui 在内部调用 elem.value = xxx 时仍会触发该错误(Layui 2.8.x 及之前版本未对每个值做 toString() 防御)。
所以不能依赖 form.val() 自动容错。实操建议:
- 设置前校验:
const safeVal = (v) => v == null ? '' : String(v) - 批量处理:
Object.keys(data).forEach(k => data[k] = safeVal(data[k])) - 如果字段多,写个工具函数封装:
cleanForForm(data),专门把对象里所有值转成字符串
数字类型(如 ID、价格)要不要强制转字符串?
要。哪怕它是 123 这样的整数,也必须转成 "123" 才能安全赋给 input.value。虽然多数现代浏览器对数字宽容,但规范要求 value 是 DOMString,且部分环境(如 Electron 旧内核、微信内置浏览器)会严格报错。
特别注意这些地方:
-
<input type="hidden" id="id">:后端返回{id: 1001},别直接dom.value = data.id -
<input type="number">:它接受数字,但value属性读出来仍是字符串;赋值时仍建议用String(),否则在某些表单重置逻辑中容易混乱 - Layui 的
select下拉框,其value属性也遵循同样规则 ——option的value必须是字符串
最稳妥的方式,是在数据进入视图层前就完成类型归一,而不是在 DOM 操作那一行临时补 + 或 '' —— 那样容易漏、难维护。



















