Azure API Management开发人员门户与已弃用开发人员门户的区别

首先明确基础定义：已弃用的开发人员门户是APIM上线早期推出的遗留版本，微软早已停止功能迭代，仅保留最低限度的运行维护，不具备长期生产使用的支撑能力。二者核心差异可以分为三类：

维护与支持等级差异 #

• 新版开发人员门户：是微软当前唯一正式主推、持续迭代的版本，所有新特性、安全补丁、合规适配都会优先落地，生产环境使用享受官方SLA保障，不存在下线风险。
• 旧版（已弃用）门户：2020年正式进入弃用周期，除了阻断级的安全漏洞修复外不会做任何更新，后续会按官方排期逐步完全关停服务，没有长期使用的稳定性承诺。

功能能力差异 #

• 自定义能力：新版内置可视化拖拽编辑器，提供现成的API试调、用户注册登录、产品订阅、代码示例生成等业务组件，支持低代码调整页面样式、扩展自定义组件，适配企业品牌视觉的成本极低；旧版没有可视化编辑能力，所有页面调整都需要直接修改原生页面模板代码，定制效率极低。
• 协议与API类型兼容：新版完整支持OpenAPI 3.0、WebSocket、GraphQL等最新的API规范与类型，内置调试控制台可以直接适配所有上述类型的API调用测试；旧版仅能完整兼容OpenAPI 2.0（Swagger）规范，对新API类型的兼容存在大量功能缺失，无法正常展示、调试非REST类的API。
• 身份认证集成：新版原生可视化配置支持Azure AD、Azure AD B2C、OAuth2.0、企业联邦账号等主流认证方式，不需要额外编写适配代码；旧版的认证逻辑硬编码在页面模板中，新认证场景需要手动改代码实现，配置成本高且容易出兼容问题。
• 发布与运维能力：新版内置版本管理、一键发布、一键回滚能力，原生支持自定义域名、CDN加速配置，不需要额外管理静态资源存储；旧版发布需要手动上传修改后的静态文件，没有版本回溯能力，运维成本高。

选型建议 #

所有新部署的APIM实例直接选用新版开发人员门户即可，不需要考虑旧版。
仅当你当前已经在旧版门户上做了深度二次开发、短期迁移成本极高且无新功能迭代需求时，可以暂时保留旧版使用，但需要尽快制定迁移计划，避免后续旧版下线影响业务。

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