在码上飞AI中实现图片上传前大小校验,需在标签添加accept="image/*"和max-size="5242880"属性,或通过汉语指令嵌入条件判断(如证件照限2MB)及自定义JS函数校验。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

在码上飞AI中实现图片上传前的大小校验,是为了防止用户误传超大文件导致流程卡顿、API失败或计费异常。不加限制时,前端可能把20MB的扫描件直接推给后端,而码上飞默认单次上传上限为5MB,超出会返回413 Payload Too Large错误,且无明确提示,用户只能看到“上传失败”。
前端表单层加HTML原生限制
在码上飞支持的HTML+汉语指令混合开发模式下,直接修改表单控件属性即可生效。
找到图片上传组件所在的表单区域,在标签中添加accept="image/*"和max-size="5242880"(单位为字节)属性。
这一步操作起来很简单,直接把属性写进标签就行,不需要额外JS监听——码上飞运行时会自动识别max-size并拦截超限文件,弹出“文件超过5MB,请重新选择”提示。
【max-size必须是纯数字,不能带单位或逗号,例如5242880正确,5MB或5,242,880错误】
汉语指令中嵌入校验逻辑
适用于需要动态判断场景,比如“用户上传证件照时限制2MB,上传背景图时放宽到8MB”。
方法一:用条件分支嵌入上传动作
在对应功能块的汉语描述中写:“当用户点击上传按钮→检查所选文件大小→如果大于2097152字节→弹出提示‘证件照不能超过2MB’并清空选择→否则执行上传”。
方法二:绑定校验函数(需启用高级模式)
先在项目设置中开启“允许调用自定义JS函数”,再在汉语指令里写:“上传前调用函数checkIdPhotoSize()→该函数返回false则中断上传”。函数体需在代码区手动补全,内容为return file.size 。
后端策略兜底(推荐必配)
仅靠前端限制不可靠,用户可禁用JS或篡改HTML绕过。码上飞支持在“API网关→上传路由→请求校验”中配置硬性规则。
第一步:进入项目后台 → 点击「部署」→「API管理」→ 找到图片上传对应的POST接口(如/api/v1/upload/image)
第二步:点击右侧「编辑校验规则」→ 在「请求体大小限制」栏填入5242880 → 保存
第三步:勾选「触发时返回友好错误」→ 输入提示文案:“图片文件不能超过5MB,请压缩后重试”
这一步必须做。前端限制只是体验优化,真正拦住非法请求的是这里。未配置时,超限请求会直接被Nginx层拒绝,前端收不到任何结构化错误信息,调试困难。











