你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
本文描述了在尝试使用 Azure Migrate 迁移 Web 应用时可能遇到的一些常见问题和特定错误。
Web 应用迁移问题
下表列出了修复下述迁移问题的步骤：
| 错误代码 | 错误消息 | 故障排除步骤 |
|---|---|---|
| 访问被拒绝 | 访问被拒绝。 | 检查错误详细信息。 原因可能是自上次 Web 应用发现以来发生了更改。 首先确认 Web 应用发现操作仍然成功，并/或排查 Web 应用发现访问问题。 |
| 添加冲突 | 角色分配已存在。 | 这可能是由于使用的是 AKS 1.23+ 版本。 如果使用的是 AKS 1.23+，请在生成 docker 映像之前按照生成容器映像中所述编辑脚本。 |
| AppContentAlready Exists | 应用程序内容 appContent.zip 在内容复制之前已存在于存储中。 | 使用新的存储帐户重试迁移。 如果此问题持续出现，请联系支持人员。 |
| AppZipUpload失败 | 将应用程序内容上传到存储帐户时出错。 | 如果这是暂时性问题，请重试操作，并确认设备与指定用于迁移的 Azure 存储帐户之间的连接正常。 |
| CopyAppContentToApplianceFailure | 将内容从 IIS Web 服务器复制到设备时出错。 | 请查看错误详细信息以了解更多信息。 确认设备与 Web 服务器之间的连接正常（例如，通过查找最近成功的 Web 应用发现）。 |
| IISWebAppExceededMaxContentSize | 内容大小超过了可以使用此工具迁移的最大内容大小 (2 GB)。 | 使用的部署方法仅支持最大 2 GB 的内容。 如果未压缩的内容大于 2 GB，则 Azure Migrate 不会尝试迁移，并会出现此错误。 Web 应用评估中应会标记此错误，其中可能会指明自上次完成 Web 应用发现以来，文件内容大小发生了更改。 |
| IISWebAppFailureCompressingSiteContent | 压缩站点内容时发生异常。 | 请查看错误详细信息以了解更多信息。 这可能与物理文件权限有关，包括阻止了用于 Web 应用发现和站点内容迁移的管理员帐户进行访问的情况。 |
| IISWebAppMigrationError | 在执行应用内容复制操作期间发生错误。 | 查看错误消息以了解更多详细信息。 |
| IISWebAppNotFoundOnServer | 在 Web 服务器上找不到与站点名称匹配的 Web 应用程序。 | 原因可能是自上次完成 Web 应用发现以来 Web 服务器上发生了更改，例如执行了站点删除或重命名操作。 确认最近是否完成了 Web 应用发现，以及该站点是否仍然存在于 Web 服务器上。 |
| IISWebAppUNCContentDirectory | Web 应用仅包含 UNC 目录内容。 目前不支持迁移 UNC 目录。 | 目前不支持迁移 UNC 共享中的内容。 如果所有站点内容都在 UNC 共享中，则会发生此错误；如果存在非 UNC 共享内容目录，则会迁移这些目录。 |
| IISWebServerAccessFailedError | 无法访问 IIS 配置。 | 原因可能是对 IIS 配置和管理 API 位置的访问权限不足。 Web 应用迁移使用与 Web 应用发现相同的标识和连接机制。 检查自上次成功完成 Web 应用发现以来设置是否已更改，以及这种发现对于此 Web 服务器是否仍然成功。 |
| IISWebServerIISNotFoundError | 未启用 IIS 管理控制台功能。 | 此错误表示未在 Web 服务器上启用 IIS 管理控制台功能，并且自上次成功完成 Web 应用发现以来可能对 Web 服务器进行了更改。 确保启用包括 IIS 管理控制台功能（“管理工具”的一部分）的 Web 服务器 (IIS) 角色，并且 Web 应用发现可以发现目标 Web 服务器的 Web 应用。 |
| IISWebServerInvalidSiteConfig | 遇到无效的 IIS 配置，未为站点定义根应用程序。 | 这表示 IIS 服务器上的一个或多个站点的站点配置无效。 为 IIS 服务器上的所有网站添加根“/”应用程序，或删除关联的（非功能性）站点。 |
| IISWebServerPowerShell错误 | 在执行 PowerShell 操作期间发生错误。 | 检查错误消息以了解更多详细信息。 远程 PowerShell 用于打包 Web 服务器中的站点内容，而无需在 Web 服务器上安装任何产品或进行计算机更改。 |
| IISWebServerPowerShellVersionLessLess4 | IIS Web 服务器上的 PowerShell 版本低于最低要求版本（PowerShell 版本 4）。 | 仅支持使用 PowerShell V4 或更高版本对 IIS Web 服务器进行迁移。 使用 PowerShell v4 更新 Web 服务器以实现这种迁移。 |
| IISWebServerUnableToConnect | 无法连接到服务器。 | 检查错误详细信息。 原因可能是自上次成功完成 Web 应用发现以来发生了更改。 首先确认 Web 应用发现操作仍然成功，并/或排查 Web 应用发现访问问题。 |
| IISWebServerZeroWebApps找到 | 在目标 IIS 服务器上未找到 Web 应用。 | 这可能表示自上次完成 Web 应用发现以来修改了 Web 服务器。 确认最近完成了 Web 应用发现，并且未从 Web 服务器中删除 Web 应用。 |
| 空结果 | PowerShell 脚本未返回任何结果。 | 远程 PowerShell 用于打包 Web 服务器中的站点内容，而无需在服务器上安装任何产品或永久性文件。 此错误可能表示 IIS 服务器上的 MaxMemoryPerShell 值太低，或者自完成 Web 应用发现以来该值已更改。 尝试使用如下所示的命令增大 IIS 服务器上的 MaxMemoryPerShell 值：Set-Item WSMan:\localhost\Shell\MaxMemoryPerShellMB 4096 |
| ResultFileContentJSONParseError | 结果采用意外的格式。 | 如果看到此错误，请联系支持人员。 |
| ScriptExecutionTimedOutOnVm | 操作超时。 | 此错误可能表示自上次完成 Web 应用发现以来，服务器上发生了更改。 检查 Web 应用发现是否仍在运行并成功。 |
| StorageAuthenticationFailed | 无法使用 Azure 存储容器进行身份验证。 | 请查看错误详细信息以了解更多信息。 |
| StorageBlobAlreadyExists | 在上传应用内容之前，应用内容 Blob 已存在。 | 使用新的存储帐户重试迁移。 |
| StorageGenericError | Azure 存储相关的错误。 | 仅当内容 (appContent.zip) 或错误文件 (error.json) 出现在站点的存储容器中时，Azure 资源管理器部署步骤才会完成 – 如果在出错的情况下 NuGet 无法上传 error.json 文件，则 Azure 资源管理器部署将会继续并等待内容，直到超时。 这可能表示设备与指定用于迁移的存储帐户之间的连接有问题。 |
| UnableToConnectToPhysicalServer | 连接远程服务器失败。 | 检查错误详细信息。 原因可能是自上次 Web 应用发现以来发生了更改。 首先请检查 Web 应用发现错误，并排查 Web 应用发现连接问题。 |
| UnableToConnectToServer | 连接远程服务器失败。 | 检查错误详细信息。 原因可能是自上次 Web 应用发现以来发生了更改。 首先请检查 Web 应用发现错误，并排查 Web 应用发现连接问题。 |
后续步骤
- 继续对 ASP.NET Web 应用执行大规模无代理迁移以迁移到 Azure 应用服务。
- 成功完成迁移后，可以根据 Web 应用特定的要求浏览以下步骤：
- 查看有关部署到 Azure 应用服务的最佳做法。