字段名不一致需立即统一,可通过三种方法解决:一是对话中强制指定下划线命名规范;二是手动修正数据模型、表单绑定及API字段并刷新;三是启用字段别名映射临时兼容。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

当你在码上飞平台生成应用后,发现后台数据库字段名(如user_id)和前台表单/接口参数名(如uid)不一致,导致提交失败、数据丢失或联调报错,必须立刻核对并统一字段命名。
确认字段不一致的具体位置
进入码上飞项目编辑页→点击右上角「开发设置」→选择「API文档」标签页→展开任一接口,查看「请求参数」与「响应字段」中的命名;再切换到「数据模型」标签页,逐条比对对应实体的字段名。这一步不能跳过,因为AI可能为同一业务字段自动生成了不同命名变体。
重点检查登录、用户、订单、报修等高频核心实体,【字段名大小写混用(如UserId vs user_id)或下划线/驼峰混用(如order_status vs orderStatus)会直接导致前端取值为空】。
方法一:在码上飞对话中强制指定字段命名规范
回到项目主对话界面,在最新消息框输入:“所有接口请求参数和数据库字段统一使用下划线命名法,例如:user_id、mobile_phone、repair_status,禁止使用驼峰。”
发送后等待AI重新生成字段映射逻辑,它会自动刷新「数据模型」和「API文档」中的字段名,并同步更新前端表单绑定和后端接口解析代码。
注意:该指令必须在项目尚未导出代码前执行,导出后修改需手动同步多处,极易遗漏。
方法二:手动修正并锁定字段映射关系
第一步:在「数据模型」页找到问题字段,点击右侧铅笔图标编辑;
第二步:将「字段标识符」改为期望的统一名称(如把uid改为user_id),保存;
第三步:立即切换到「页面设计」→选中对应表单组件→在右侧属性面板中,将「绑定字段」下拉选项手动切换为刚修改的新字段名;
第四步:返回「API文档」页,点击该接口右侧的「刷新字段」按钮,强制同步响应结构;
这四步必须严格按顺序执行,否则前端仍会向旧字段名提交数据,而后端已不再接收该字段,造成静默丢数。
方法三:用字段别名机制做兼容过渡
方法三适用于已上线、无法停机修改的场景。在「API文档」页→点击问题接口→展开「高级设置」→勾选「启用字段别名映射」→在弹出框中填写:{"uid": "user_id", "tel": "mobile_phone"};
该配置让后端自动将传入的uid转为user_id存入数据库,响应时再把user_id转成uid返回给前端,无需改动前后端任何一行代码。
【此方式仅作临时兼容,不可长期依赖;别名映射不参与数据校验与索引优化,性能损耗明显】。


















