关于前后端接口联调的问题讨论

[zy0829]

技术经理提出了一个要求： 后端提前设计好 api 文档，前端按照文档 mock 开发，然后也不需要联调这个过程。

我在想这样真的就不需要联调了吗？往往身边的同事连个文档都不会看，让前后端按照文档开发真的可行吗？这样会不会更繁琐

[weixind]

前后端按照约定开发完了，放到一块不用联调就能跑通这个效果能实现。不过很看开发和前期沟通水平。你既然问了，贵司九成九实现不了。

[est]

这个其实你不用想，问问身边的人有没有成功案例就知道了


我估计 90%后期也要改 api 的。哪有一次设计成功那么简单的。。。。。

[28Sv0ngQfIE7Yloe]

>>>.后端提前设计好 api 文档

这个也是需要前端参与的，有些前端是不处理任何业务逻辑的，格式要求很敏感。

[wangtian2020]

开发完毕后还是会进入联调的阶段的。不需要联调就纯扯淡
水平想当的情况下，前端设计的 api 会更完善一点，后端设计接口时容易页面看都不看，页面该显示的数据不返回。
后端设计接口也好，我当前端的省力，接口有问题再对后端提出修改意见
写 api 文档要用成熟的 api 接口管理网站，用过 eolink 、apifox 功能齐全都不错

[whoami9426]

简单业务下没有问题,复杂的业务依旧需要联调,当然后端把单测写的足够好也能减少联调的必要

[xianyv]

我(后端)也想这样,可是受限于和我合作的前端的水平,他连个接口文档都看不明白的人, 我还不如直接开发完,告诉他怎么用呢.

[Jinyang7]

只能说这样，测试时候一堆 bug/doge

[liangxiaowen]

还是按项目来。
如果接口多，可以这样做，几十个接口还有有文档查询一下好。
如果要改，改完知会一下就好了。
这么多接口应该也不会改太多，毕竟工作量也大。
手写文档复杂，就使用 swagger 之类就好

[xFrye]

开发不联调，到时候上线是不是要通宵测试 🐶

[zy0829]

经理提出这个要求目的是为了提高版本质量， 我是感觉跟质量不质量的不太搭嘎

[sarices]

我们就是这样做，但因为水平，或者对业务理解不够透彻，有时候会在实际联调的时候做大改动，还有就是有前后端没有严格按照文档来做，导致有些字段类型明明是 string ，偏偏返回了 number 之类的，还有就是文档有误，字段太多，检查不过来，特别是我们这些做后台业务的，一个接口返回几十个字段是常有的事

[debuggerx]

全栈开发，一个人把前后端都写了，自然也就不需要联调过程了。
当然对开发水平要求比较高，不是随便一个会写点前端的后端或者对后端一知半解的前端就能玩得转的。
有幸曾在一家外企创业团队待过，开发时一个人就负责一整个需求，需要什么就写什么，前端、后端、db 、mq 、cms 后台，信息模板……，需求涉及到的就一口气全做了，效率极高，问题很少，对团队和个人成长都有好处……

[zy0829]

@sarices 那不是很痛苦吗

[zy0829]

@Jinyang7 经理说这么做是为了减少 bug ，还说我们做单元测试没意义

[zy0829]

@weixind 水平确实拉

[zy0829]

@est 不用问工作 6 年没见过这么执行的

[zy0829]

@whoami9426 经理说单测没意义，我感觉他只会一张嘴也没意义

[linshuizhaoying]

你技术经理是不是没啥项目经验

[liuyd]

前提是前端也要理解业务逻辑，不了解业务逻辑看文档费劲，我遇到的前端基本只关心页面交互，写了文档还得讲一遍，沟通成本高所以我们直接干掉中间环节，后端先启动，文档用 swagger 啥的生成一个就行。

[zy0829]

@linshuizhaoying 菊花厂出来的