你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

排查群集配置问题

注意

我们将于 2025 年 1 月 31 日停用 Azure HDInsight on AKS。 在 2025 年 1 月 31 日之前，你需要将工作负荷迁移到 Microsoft Fabric 或同等的 Azure 产品，以避免工作负荷突然终止。 订阅上的剩余群集会被停止并从主机中移除。

在停用日期之前，仅提供基本支持。

重要

此功能目前以预览版提供。 Microsoft Azure 预览版的补充使用条款包含适用于 beta 版、预览版或其他尚未正式发布的 Azure 功能的更多法律条款。 有关此特定预览版的信息，请参阅 Azure HDInsight on AKS 预览版信息。 如有疑问或功能建议，请在 AskHDInsight 上提交请求并附上详细信息，并关注我们以获取 Azure HDInsight Community 的更多更新。

群集配置不当可能会导致部署错误。 通常，当 ARM 模板中提供的配置不正确或 Azure 门户中（例如在“配置管理”页上）的输入错误时，会发生这些错误。

注意

造成以下错误的原因带有“User.”前缀。

示例配置错误：

下表提供错误代码及其说明来帮助诊断和修复常见错误。

配置错误

错误代码	说明
User.TrinoError	Trino 进程启动失败，出现一般性错误。 在服务配置文件中验证 trino 特定的配置文件。
User.Configuration.TrinoError	Trino 进程启动失败，出现应用程序配置错误。 在服务配置文件中验证 trino 特定的配置文件。
User.Configuration.FileForbidden	不允许更改某些 trino 配置文件。
User.Configuration.ParameterForbidden	不允许更改某些 trino 配置参数。
User.Configuration.InvalidComponent	指定的服务组件无效。 有关详细信息，请参阅服务配置文件。
User.Configuration.MiscFile.InvalidName	杂项 fileName 无效。 有关详细信息，请参阅杂项文件。
User.Configuration.MiscFile.InvalidPath	杂项文件路径太长。
User.Configuration.MiscFile.NotFound	找到 MISC 标记，但在杂项文件配置中没有相应的文件。 有关详细信息，请参阅杂项文件。
User.Configuration.MiscFile.DuplicateName	在杂项文件配置部分中找到重复的 fileName 值。
User.Configuration.MiscFile.DuplicatePath	在杂项文件配置部分中找到重复的路径值。
User.Configuration.FormatError	服务配置格式错误，在错误的部分中使用了内容/值属性。 有关详细信息，请参阅服务配置文件。
User.Configuration.HiveMetastore.MultiplePasswords	catalogOptions.hive 目录中指定了多个密码。 指定 metastoreDbConnectionPasswordSecret 和 metastoreDbConnectionPassword 这两个属性中的一个。
User.Configuration.HiveMetastore.PasswordRequired	catalogOptions.hive 目录所需的密码。 指定 metastoreDbConnectionPasswordSecret 和 metastoreDbConnectionPassword 这两个属性中的一个。
User.Secrets.Error	Azure KeyVault 中的机密和权限配置错误。
User.Secrets.InvalidKeyVaultUri	secretsProfile 中缺少 Azure Key Vault URI。
User.Secrets.KeyVaultUriRequired	secretsProfile 中缺少 Azure Key Vault URI。
User.Secrets.DuplicateReferenceName	在 secretsProfile 中找到重复的 referenceName。
User.Secrets.KeyVaultObjectUsedMultipleTimes	相同的 Key Vault 对象/版本在 secretsProfile 中的机密列表中作为不同的引用被多次使用。
User.Secrets.NotSpecified	找到 SECRET_REF 标记，但 secretsProfile 中没有相应的 secret 对象。
User.Secrets.NotFound	在 KeyVault 中未找到 secretsProfile 中指定的 Key Vault 对象。 验证对象的名称、类型和版本。
User.Plugins.Error	存储帐户中的插件或权限配置错误。
User.Plugins.DuplicateName	群集配置 userPluginsSpec 中使用了重复的插件名称。
User.Plugins.DuplicatePath	群集配置 userPluginsSpec 中使用了重复的插件路径。
User.Plugins.InvalidPath	插件的存储 URI 格式不正确。
User.Plugins.PathNotFound	在存储帐户中找不到插件的指定路径。
User.Telemetry.InvalidStoragePath	userTelemetrySpec 中的存储 URI 格式不正确。
User.Telemetry.HiveCatalogNotFound	在 userTelemetrySpec 中为遥测表指定了不存在的 Hive 目录作为目标。
User.CatalogOptions.HiveCatalogNotFound	对于给定的 catalogOptions.hive 配置，在 trino 目录服务配置文件中找不到 Hive 目录。 有关详细信息，请参阅 Hive 元存储。

系统错误

某些错误可能因环境条件导致，并且可能是暂时性的。 导致以下错误的原因带有“System.”前缀。 在这种情况下，请尝试以下步骤：

1. 收集以下信息：
   1. Azure 请求 CorrelationId。 可通过三种方式查找此信息：通知区域，群集在部署页面上所在的资源组，或者 az 命令输出。
   2. DeploymentId. 可在群集概述页面中找到此信息。
   3. 详细错误消息。
2. 请与支持团队联系以获取此信息。

错误代码	说明
System.DependencyFailure	其中一个群集组件中出现故障。