Node/Express集成REST与GraphQL时POST请求挂起问题咨询

一、GraphQL与Express REST不存在原生兼容冲突 #

你遇到的请求挂起问题属于服务配置错误，并非两类接口设计的原生冲突。REST和GraphQL完全可以在同一套Express服务中共存，官方从未要求二者必须二选一。

二、导致GraphQL POST请求挂起的常见原因 #

• 缺失body解析中间件：express-graphql依赖express.json()或express.urlencoded()解析POST请求体，如果你仅给REST接口配置了局部body解析，全局或GraphQL路由未挂载对应解析中间件，会导致请求体一直处于pending状态，服务端无法拿到完整请求就不会返回响应，最终触发Postman的read RECONNECT错误。
• 路由匹配顺序错误：如果你的通配REST路由（如app.all('*')）、全局REST拦截中间件的注册顺序早于GraphQL路由，且未调用next()流转请求，GraphQL路由完全接收不到请求，也没有对应的返回逻辑，就会导致请求挂起。
• Resolver异步逻辑异常：如果你的resolver返回的Promise未处理异常捕获，或是TypeScript类型定义和实际返回值不匹配导致异步逻辑一直处于pending状态，也会触发请求无响应。
• CORS配置范围有误：如果POST请求跨域，你仅给REST接口配置了CORS响应头，GraphQL路由未处理预检OPTIONS请求，也会导致正式POST请求挂起。

三、快速验证方法 #

你可以先尝试用GET方式调用GraphQL接口，将query参数直接拼接在请求URL中，如果能正常返回结果，即可100%定位为POST请求的body解析或CORS配置问题，直接检查对应中间件的挂载顺序、作用范围即可。

四、关于GraphQL被建议替代REST的说明 #

GraphQL从来不是REST的完全替代方案，只是在部分业务场景下相比REST有更高的效率：

• 单请求可获取多资源，减少前端多次HTTP请求的开销
• 前端可自定义返回字段，避免REST接口返回冗余字段，也无需后端为不同前端场景单独定制接口
• 自带类型校验与接口文档能力，无需额外维护接口文档和参数校验逻辑
  两类方案完全可以根据业务场景搭配使用，不存在非此即彼的要求。

内容的提问来源于stack exchange，提问作者Brian Quinn