密钥对身份验证：故障排除¶

找到错误¶

在进行故障排除之前，您需要确定问题是否导致了 JWT token is invalid 错误。

如果您的 Snowflake 客户端是没有交互式界面的驱动程序或连接器，请使用日志检查连接错误：

1. 启用 Snowflake 连接器或驱动程序的日志记录。有关详细信息，请参阅 为 Snowflake 驱动程序和连接器生成日志文件 (https://community.snowflake.com/s/article/How-to-generate-log-file-on-Snowflake-connectors) （Snowflake 知识库文章）。

2. 检查包含字符串 JWT token is invalid 的错误。

   例如，使用 Snowflake JDBC 驱动程序的客户端在尝试使用密钥对身份验证时可能会出现以下错误：

   yyyy-mm-dd hh:mm:ss.nnn n.s.c.jdbc.SnowflakeSQLException FINE <init>:40 -
   Snowflake exception: JWT token is invalid. [0ce9eb56-821d-4ca9-a774-04ae89a0cf5a],
   sqlState:08001, vendorCode:390,144, queryId:
   

检索更多详细信息¶

每个 JWT token is invalid 错误都包含 UUID，该 UUID 在错误发生后立即出现在括号中（例如，JWT token is invalid. [0ce9eb56-821d-4ca9-a774-04ae89a0cf5a]）。您应该向 Snowflake 管理员提供错误的 UUID，以便他们可以获得有关错误的更多信息。

管理员使用 SYSTEM$GET_LOGIN_FAILURE_DETAILS 函数来获取有关错误的更多详细信息。例如，获取有关 JWT token is invalid. [0ce9eb56-821d-4ca9-a774-04ae89a0cf5a] 错误的更多信息，具有 ACCOUNTADMIN 角色的用户可以执行：

SELECT JSON_EXTRACT_PATH_TEXT(SYSTEM$GET_LOGIN_FAILURE_DETAILS('0ce9eb56-821d-4ca9-a774-04ae89a0cf5a'), 'errorCode');

JSON_EXTRACT_PATH_TEXT 函数用于解析 SYSTEM$GET_LOGIN_FAILURE_DETAILS 函数的 JSON 输出，以检索错误代码和错误消息。

错误列表¶

SYSTEM$GET_LOGIN_FAILURE_DETAILS 函数的输出是以下错误代码/错误组合之一。

常见错误和解决方案¶

与密钥对身份验证相关的最常见错误是：

• JWT_TOKEN_INVALID

• JWT_TOKEN_INVALID_PUBLIC_KEY_FINGERPRINT_MISMATCH

• JWT_TOKEN_INVALID_USER_IN_ISSUER

• JWT_TOKEN_INVALID_ISSUE_TIME

使用以下描述和解决方案对这些错误进行故障排除。