为何NextJS的NextApiRequestCookies、parseBody未从主包导出且无官方文档

• 这些存放在next/dist/路径下的内容本质是Next.js构建阶段输出的内部代码，设计初衷就是仅供给框架自身运行时调用，并非面向开发者的公开能力。
• 首先是为了满足框架内部复用需求：你用到的parseBody、NextApiRequestCookies都是Next.js内置API路由、服务端渲染逻辑的通用依赖，框架本身处理请求时需要解析请求体、读取cookie结构，这些工具和类型是为了减少内部代码冗余设计的，从定位上就不属于面向开发者的开放能力。
• 其次是为了降低框架的维护成本、规避版本兼容风险：如果将这类内部API从next主包对外导出，官方就需要长期稳定维护其入参、出参、执行逻辑的一致性，否则会导致依赖这些API的项目在升级Next.js版本时出现故障。而内部工具的逻辑需要跟随框架迭代灵活调整，比如适配新的请求协议、调整内部cookie解析规则时，内部方法可以任意修改无需考虑外部调用兼容，因此官方不会将这类工具纳入公开导出范围。
• 最后是公开API的筛选规则限制：Next.js对外公开的API都经过了场景评估、文档完善、全场景测试覆盖，很多内部工具要么适用场景极窄，要么官方已经提供了更通用的公开替代方案——比如现在可以直接通过next/server导出的cookies()方法读取cookie、API路由以及App Router的路由处理器中也已经内置了请求体自动解析能力，完全可以覆盖大多数开发者的需求，没有必要额外开放内部工具增加维护负担。

提醒：直接从next/dist/路径下引入内容的用法没有官方兼容保障，哪怕当前版本可以正常运行，后续次版本、补丁版本升级都可能出现路径变更、方法删除等问题，建议优先使用官方公开的API替代。

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