发生了什么
免时长是平台提供给商户的一种免费额度:约定期限内,用户使用换电服务不产生费用。额度按天记账,由运营在后台的免时长配置页按批次录入。一条批次记着这批天数属于哪个商户、城市、套餐类目,配多少块电池,还剩多少天没分配。每条批次还要附付款凭证,也就是运营上传的付款凭证图片,系统把它存成一组图片地址,下面叫图片列表。
批次有两个写入入口。一个是运营在后台页面手工新建:该页面要求付款凭证必传,不传图片提交不了,从这里产生的批次一定带着图片列表。另一个是工作流申请:申请人提交流程,审批通过后生成一条批次;这条路径不要求上传付款凭证,字段可以留空。
复制是常用操作:运营在列表点某条批次的复制,系统以它为模板把各字段填进新建弹窗,运营改天数、日期后提交,生成一条新批次,被复制的那条不受影响。弹窗里的付款凭证是一个上传控件,已有图片会显示在这里,也可以继续追加。
这次复制的是工作流申请来的批次,申请时没有传付款凭证。点开复制后,弹窗里图片上传没有反应,选不了文件也传不上去;新增批次又要求付款凭证不能为空,这条批次就复制不出来。
本质
复制弹窗要做的第一件事,是把被复制批次的详情读出来回显到表单里。写这段代码时,开发按“付款凭证是必传字段”来写:详情返回的图片列表被直接当成一个数组使用,比如遍历它生成上传控件的文件项,或先取长度判断有没有图片。这个假设在后台页面新建的批次上一直成立,因为页面本身卡了必填。
问题在于数据有两个来源,必填规则只在一处成立。工作流申请生成的批次里,付款凭证是选填的,申请人不传时,返回的数据里根本没有这个字段——不是空数组,也不是 null,而是整个键不存在。前端读出来就是 undefined。
同一个字段在页面入口是必填、在工作流入口是选填,读取方却按必填写死:遇到缺失字段时读到 undefined,紧接着对它取属性或调方法就会抛错。
按执行顺序看:
- 运营点复制,弹窗向详情接口要这条批次的数据,接口原样返回,工作流来源的这条没有图片列表。
- 弹窗初始化时,代码直接对这份数据里的图片列表做数组操作,例如遍历它来生成上传控件的文件项。
- undefined 上没有这些数组方法,代码抛错,弹窗初始化中断,上传控件的文件项没被赋值,界面表现就是点上传没反应。
- 提交时付款凭证是必填项,表单里拿不到图片列表,校验同样过不去。
整个复制流程就卡在这里。修复方向是兼容空数据:读取这类字段时先判断是不是数组,缺失或空值统一按空列表处理,再交给表单和上传控件;同时把两个入口的字段约束对齐——要么工作流申请也要求上传付款凭证,要么页面上的必填校验允许为空,否则同样的数据换到别的页面还会出问题。修复的发布与回归结果未在材料中体现。
下面两段代码是脱敏教学示例,用于对比取值前后该做什么,不代表实际项目源码或已上线实现。
错误代码
// 复制弹窗:按被复制批次回显新增表单(脱敏教学示例)
export default {
data() {
return { dataForm: { imageUrls: [] }, fileList: [] };
},
methods: {
async openCopy(batchId) {
const detail = await this.fetchBatchDetail(batchId);
this.dataForm = { ...detail };
// 为什么错:把图片列表当成一定存在的数组直接遍历,
// 工作流来源的批次没有这个字段,这里是 undefined
this.fileList = detail.imageUrls.map(url => ({ name: url, url }));
},
submit() {
// 为什么错:字段缺失时读 undefined 的长度同样会抛错,
// 必填校验连“请上传付款凭证”的提示都弹不出来
if (this.dataForm.imageUrls.length === 0) {
return this.$message.error('请上传付款凭证');
}
this.createBatch(this.dataForm);
}
}
};
修复代码示例
// 同一段回显逻辑:先把缺失字段归一成空数组再使用
export default {
data() {
return { dataForm: { imageUrls: [] }, fileList: [] };
},
methods: {
async openCopy(batchId) {
const detail = await this.fetchBatchDetail(batchId);
// 两个入口的必填约束不同,读取方不能假设字段一定存在:
// 缺失、null 都归一成空列表
const imageUrls = Array.isArray(detail.imageUrls) ? detail.imageUrls : [];
// 注意展开顺序:先铺开详情,再用归一后的值覆盖,避免旧值盖回去
this.dataForm = { ...detail, imageUrls };
// 归一之后遍历是安全的,上传控件拿到空列表而不是中断
this.fileList = imageUrls.map(url => ({ name: url, url }));
},
submit() {
// 必填校验保留:要复制工作流来源的批次,仍需运营补传凭证
if (this.dataForm.imageUrls.length === 0) {
return this.$message.error('请上传付款凭证');
}
this.createBatch(this.dataForm);
}
}
};
下次遇到这些场景要警惕
- 给表单字段加必填校验之前:把这个字段的所有写入入口列出来,逐个确认是否都保证有值(页面手工新建、审批流生成、导入或接口同步);只要有一个入口允许为空,读取方就按“字段可能整个不存在”处理。
- 上线复制、另存为、以旧建新这类功能时:拿另一入口生成的数据当模板复制一遍,并专门构造字段缺失(不是空数组、不是 null)的记录,观察弹窗能否打开、必填项能否提交。
- 改接口返回结构或收紧字段约束时:在详情接口出口统一补默认值,而不是只在前端某处判空;同一字段在列表、详情、导出各有各的读法时,漏掉一处就会再出一次。
- 修完这个弹窗之后:把历史未传付款凭证的工作流批次都复制一遍,确认能正常提交;同时确认提交接口对空图片列表的处理与页面提示一致,避免页面放行、后端再拦。