前端联调出问题时，很多人第一反应是“后端接口挂了”或“前端请求错了”。其实大部分问题可以通过一张自检表快速缩小范围：请求有没有发出、发到哪里、带了什么凭据、服务返回了什么、页面如何处理。
先确认请求本身
浏览器 Network 面板是第一现场。先看请求 URL、方法、状态码、请求体、响应体和耗时。查询接口默认 GET，写操作走语义明确的 POST 路径；如果项目约定不使用 PUT、PATCH、DELETE，联调时就不要临时绕过去。
请求体要和接口文档一致，尤其是数组、枚举、时间字段和分页参数。前端不要把未校验的用户输入直接丢给后端，后端也应该有 schema 校验兜底。
跨域和代理分开看
跨域错误不一定是接口错误。先区分是浏览器 CORS 拦截，还是本地 dev server 代理没有转发成功。CORS 问题通常在响应头里找答案，代理问题则要看 Vite、Nginx 或本地服务日志。
如果同一个接口 curl 能通、浏览器不通，优先检查跨域、Cookie、预检请求和协议是否一致。如果浏览器和 curl 都不通，再看后端服务、网关和 DNS。
鉴权要看凭据是否真的带上
登录态问题常见于 Cookie 域名、SameSite、HTTPS、本地端口和 token 刷新。不要只看 localStorage 里有没有 token，要看请求头里是否带出去了，后端是否识别，失败时返回的是 401、403 还是业务错误码。
后台管理接口还要确认角色、菜单权限和按钮权限。页面隐藏按钮不等于接口安全，接口层仍要校验权限。
错误提示要能指导用户
联调不只是让接口返回 200。参数错误、权限不足、重复提交、网络超时、服务异常都要有对应页面反馈。技术错误可以进日志，用户看到的文案应该告诉他下一步能做什么。
一张好的联调自检表，会让问题从“谁的锅”变成“证据在哪”。这才是前后端协作真正省时间的地方。
