使用Azure Data Studio SQL迁移扩展无法获取订阅且手动添加报错

适用场景：Azure Data Studio已完成Azure账户连接，使用v0.1.12版本Azure SQL Migration扩展迁移本地SQL Server到Azure SQL Managed Instance时，出现订阅列表无法拉取、手动录入订阅信息触发报错的问题。
问题现象参考：

第一步：修复版本兼容问题 #

v0.1.12为较早的预览版本，存在Azure Resource Manager鉴权逻辑的已知bug，会直接导致订阅拉取、手动录入鉴权失败，优先执行以下操作：

• 打开Azure Data Studio左侧扩展面板，搜索Azure SQL Migration，点击更新将扩展升级到最新稳定版，升级完成后完全重启Azure Data Studio再重试操作。
• 如果升级后问题复现，可回退验证v0.1.11正式版本，排除最新版本的本地适配问题。

第二步：校验账号与权限配置 #

• 确认登录账号权限：当前登录Azure Data Studio的账号，需要在目标订阅下至少拥有Contributor、SQL Managed Instance Contributor两个角色权限，无对应权限时订阅会被默认过滤不展示，可登录Azure门户进入目标订阅的「访问控制(IAM)」面板确认权限分配。
• 校验租户匹配：如果账号同时归属多个Azure AD租户，点击Azure Data Studio左下角账户图标，找到已连接的Azure账户，切换到目标托管实例所在的对应租户，再刷新扩展页面重试。
• 确认订阅状态：登录Azure门户检查目标订阅未处于禁用、欠费过期、额度耗尽的异常状态，异常状态订阅无法被扩展正常读取。

第三步：修复网络与缓存问题 #

• 检查网络连通性：确认运行Azure Data Studio的机器可以正常访问对应云环境的资源管理终结点（公有云为management.azure.com），无本地防火墙、安全策略拦截对应请求；如果使用代理上网，进入Azure Data Studio设置页-应用程序-代理，填入正确的代理地址后重启工具。
• 清除身份缓存：退出当前登录的Azure账户，完全关闭Azure Data Studio，删除本地Azure身份缓存目录下的所有文件：
  • Windows：%APPDATA%\azuredatastudio\Azure Accounts
  • Mac：~/Library/Application Support/azuredatastudio/Azure Accounts
  • Linux：~/.config/azuredatastudio/Azure Accounts
    删除完成后重新打开工具，重新登录Azure账户再尝试拉取订阅。

第四步：手动录入报错专项排查 #

如果自动拉取始终失败，手动录入时按以下规则校验配置：

• 填写参数格式校验：订阅ID、租户ID需填入纯GUID格式，不要带多余空格、多余特殊字符，确认填写值和Azure门户内展示的属性完全一致。
• 云环境选择校验：手动录入时选择的云环境必须和资源所属环境匹配，比如世纪互联运营的Azure中国需要选择Azure China，政府云需要选择对应政府云选项，选错云环境会直接导致接口请求地址错误触发报错。
• 服务主体认证校验：如果手动录入选择服务主体认证方式，需要确认服务主体已被授予目标订阅的对应操作权限，且客户端密钥未过期、密钥值填写无错误。
• 临时关闭本地流量拦截类软件：部分安全软件、流量审计工具会篡改Azure API请求的鉴权头，临时关闭这类软件后再重试录入操作。

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