客户的询盘表单提交一直失败，前端说接口返回报错是后端的问题，后端说前端传的参数格式不对，两边在群里各执一词，客户夹在中间听天书。网页前端开发和后端的协作，如果没有事先划清的界线，联调阶段就是甩锅的高发期，这种局面其实可以提前避免。
先定接口文档，再动手写代码
很多项目是前端先画完页面、后端搭完库，最后碰头对接，效率最低。正确的顺序是开工前先一起把接口文档定下来：每个接口的地址、传什么参数、返回什么结构、出错返回什么码。文档定了，前端可以照着假数据先把页面交互做完整，后端照着文档实现接口，两边并行，最后合体时偏差极小。没有文档的联调，全靠两边猜，猜错一轮就是几天的返工。
分界线画在哪
几个最容易扯皮的点，事先约定好归属：
- 数据校验：前端做提示体验，比如没填邮箱立刻标红；后端做最终把关，防止绕过页面直接提交假数据。两边都做，不是二选一；
- 错误提示：接口失败时，页面上给用户看的那句话由前端负责写得友好，具体错误码由后端负责给全；
- 时间与时区、金额单位这类约定，文档里写死，别靠口头。
有个做外贸系统的团队还加了一条：联调阶段发现的问题，先在文档里补一条记录再修代码，一个月下来文档越用越厚，扯皮越来越少。联调顺利的项目有个共同点：两边都用文档说话，群里吵架一小时，不如文档里补一行定义来得快。
联调要有环境和时间盒
别在各自电脑上联调，搭一个共同的测试环境，两边都把代码部署上去，问题当场复现。联调时间也要框住，比如集中三天，每天下午固定半小时同步，问题列表当天清零。无限拖长的联调是项目延期的常见原因，时间盒逼着双方把问题摊开快断快结。另外提醒甲方一句：联调阶段你的测试反馈也有价值，真按用户的方式走一遍流程，很多技术方互相看不见的问题就浮出来了，别客气，尽早提，越早改越便宜。联调期问题最便宜，上线后问题最贵。网页前端开发的联调纪律，本质是项目管理纪律。
两条建议：外包项目验收时把接口文档列为交付物，缺文档的对接永远处于半失控状态；你作为甲方主持联调时，坚持让两边把问题写成文字记录，谁的责任按文档裁，几天就能磨合顺畅。比格网络的前后端是一个团队内部协作，接口文档先行是铁规，客户不用当传话筒。
