翻译问题排查

以下各部分列出了用户可以采取的步骤，以排查 Vertex AI Translation 错误。

AITR2030 - TranslationServiceInvalidArgument

翻译服务请求实参无效。这是请求中参数无效的默认错误代码。如需了解详情，请查看错误详情和日志。

AITR2031 - TextTranslationInvalidArgument

文本翻译请求实参无效。

错误消息示例：

  • 翻译请求中的内容为空。

    • 翻译请求中的 contents 字段为空。
    • 在请求的 contents 字段中添加句子文本。

  • mime_type 参数无效。

    • 翻译请求中的 mime_type 字段无效。
    • 支持的值包括 text/plain 和 text/html。
    • 如果 mime_type 字段为空，则默认值为 text/html。

  • 语言对不受支持。

    • 翻译服务不支持此源语言和目标语言对。
    • 目标语言必须是英语。如需查看源语言列表，请参阅支持的语言。
    • getSupportedLanguages 方法会返回所有受支持的语言。

  • 语言为空。

    • 请求中的源语言或目标语言代码为空。
    • 检查翻译请求中的源语言或目标语言代码字段，确保该字段不为空。如需查看源语言和代码的列表，请参阅支持的语言。

  • 未知语言。

    • 请求中的源语言代码或目标语言代码不是 BCP-47 语言代码，因此无效。
    • 检查翻译请求中的源语言或目标语言代码字段，确保其使用的是 BCP-47 语言代码。

AITR2033 - GlossaryInvalidArgument

词汇表请求实参无效。

错误消息示例：

  • 术语表名称无效。

    • 词汇表名称或 GET HTTP 网址的格式不正确。例如，正确的格式为 projects/PROJECT_ID/glossaries/GLOSSARY_ID。
    • 如果您使用的是 gRPC，请检查请求中词汇表字段的格式。
    • 如果您使用的是 GET HTTP，请确保您的网址采用以下格式：/v1alpha1/projects/PROJECT_ID/glossaries/GLOSSARY_ID。

  • 项目名称无效。

    • 项目名称的格式不正确。错误格式的一个示例是 projects/PROJECT_ID。对于 HTTP 网址，错误的格式可能是 projects/PROJECT_ID/glossaries。
    • 如果您使用的是 gRPC，请检查请求中父字段的值，确保格式正确。
    • 如果您使用的是 HTTP，请确保网址正确无误。例如，正确的格式为 /v1alpha1/projects/PROJECT_ID/glossaries。

  • 过滤条件无效。

    • 词汇表列表过滤条件无效。术语库列表过滤条件仅支持按源语言和目标语言进行过滤。例如，src=fr或 src=fr和 tgt=en。
    • 如果您使用的是 gRPC，请检查请求中的过滤条件字段，并确保其正确无误。
    • 如果您使用的是 GET HTTP，请确保网址正确无误。例如，正确的格式为 /v1alpha1/projects/PROJECT_ID/glossaries?filter=XXXX。

  • 页面令牌无效。

    • 词汇表列表页面令牌无效。page_token 字段的值应与您之前 list 字库响应中返回的 next_page_token 字段的值相同。令牌可能会发生变化，或者可能缺少一些字符。
    • 如果您使用的是 gRPC，请检查 page_token 字段的值是否与上一个列表响应中返回的 next_page_token 字段的值相同。
    • 如果您使用的是 HTTP，请检查网址中 page_token 字段的值是否正确。例如，正确的格式为 /v1alpha1/projects/PROJECT_ID/glossaries?page_token=XXXX。

  • CSV 文件中的数据行有误。

    • 词汇表输入文件中至少有一行包含错误数据。
    • 检查词汇表输入文件，确保数据采用有效格式。

  • 语言代码 {language code, column info} 的列重复。

    • 至少有两列共享相同的语言代码。
    • 查看错误详情，找出存在问题的列。

  • CSV 文件中的有效语言不足。

    • 必须包含至少两种不同语言的术语。
    • 词汇表输入文件必须至少包含两种不同的语言。

AITR2034 - JobInvalidArgument

错误消息示例：

  • 操作名称无效。

    • 检查操作名称。
    • 预计采用 projects/PROJECT/operations/OPERATION_ID 格式。

  • 项目名称无效。

    • 项目名称必须采用以下格式：projects/PROJECT_ID。
    • HTTP 网址必须采用 projects/YOUR_PROJECT_ID/glossaries 格式。
    • 如果您使用的是 gRPC，请检查请求中的父字段，确保其格式正确。
    • 如果您使用的是 HTTP，请确保您的网址采用以下格式：/v1alpha1/projects/PROJECT_ID/glossaries。

  • 页面令牌无效。

    • 确保 ListOperationRequest 方法调用中的 list_token 字段的值为数值。
    • 如果您使用的是 gRPC，请检查 page_token 字段的值是否与上一个列表响应中的 next_page_token 字段的值相同。
    • 如果您使用的是 HTTP，请检查网址中 page_token 字段的值是否正确。例如，正确的格式为 /v1alpha1/projects/PROJECT_ID/glossaries?page_token=XXXX。

AITR2035 - DetectLanguageInvalidArgument

语言检测请求实参无效。

错误消息示例：

  • mime_type 参数无效。

    • detectLanguage 请求中的 mime_type 参数无效。
    • 使用 text/plain 或 text/html 值。text/html 值是默认值。

  • detectLanguage 方法调用中的 content 字段为空。

    • 确保请求中的 content 字段不为空。

AITR2053 - GlossaryNotFound

处理词汇表请求时未找到服务器。

错误消息示例：

  • 术语表 {project_id: PROJECT_ID, glossary_id: GLOSSARY_ID} 不存在。
    • 术语表：{project_id: PROJECT_ID, GLOSSARY_ID} 不存在。
    • 指定项目中的 glossary_id 词库不存在。必须先创建词汇表，然后才能查询它。
    • 在查询术语表之前，检查是否已创建术语表。
    • 如果您使用的是 gRPC，请检查请求中的词汇字段，确保其正确无误。
    • 如果您使用的是 GET HTTP，请确保网址正确无误。例如，正确的格式为 /v1alpha1/projects/PROJECT_ID/glossaries/GLOSSARY_ID。

AITR2054 - JobNotFound

错误消息示例：

  • 找不到相应 ID 的作业。
    • 未能找到特定的 async 操作。
    • 数据库中不存在 async 操作：
      • 检查请求中的操作 ID。
      • 如需更多帮助，请与支持专家联系。

AITR2060 - TranslationServiceAlreadyExists

某些实体已存在。

  • 重试请求。
  • 如需更多帮助，请与支持专家联系。

AITR2063 - GlossaryAlreadyExists

词汇表已存在。

错误消息示例：

  • 已存在具有相同源文本和目标文本的术语表条目。

    • 使用术语库进行翻译时，术语库中的某些条目会共用相同的源文本和目标文本。
    • 确保数据库服务中的词汇表没有具有相同源文本和目标文本的重复条目。

  • 已存在同名词汇表。

    • 已存在同名的其他术语表。
    • 为新词汇表使用其他名称。

AITR2090 - TranslationServiceFailedPrecondition

翻译服务未处于执行相应操作所需的状态。

错误消息示例：

  • 创建对齐器上下文时，没有匹配的文件。
    • 对齐器服务是翻译功能运行的服务之一。对齐器服务因缺少模型文件而无法运行。
    • 如需更多帮助，请与支持专家联系。

AITR2093 - GlossaryFailedPrecondition

翻译服务尝试使用术语库，但术语库未处于正常运行所需的状态。

错误消息示例：

  • 发现术语表条目过大。
    • 词库输入文件包含大小 (bytes) 超过允许的最大字节数 (max_bytes) 的条目。
    • 更新术语表，使其长度不超过 max_bytes。

AITR2130 - TranslationServiceInternal

错误消息示例：

  • 未能启动数据库事务。

    • 重试请求。
    • 如需更多帮助，请与支持专家联系。

  • 未能结束数据库事务。

    • 重试请求。
    • 如需更多帮助，请与支持专家联系。

  • 未能回滚未提交的数据库事务。

    • 重试请求。
    • 如需更多帮助，请与支持专家联系。

  • 未能翻译文本。

    • 输入内容超过了 1024 个字符的长度上限。
    • 遵循注意事项中的建议。
    • 重试请求。
    • 如需更多帮助，请与支持专家联系。

AITR2133 - GlossaryInternal

错误消息示例：

  • 未能获取术语表。

    • 由于连接问题，无法从数据库中检索术语表。
    • 重试请求。
    • 如需更多帮助，请与支持专家联系。

  • 无法解压缩删除术语元数据。

    • 重试请求。
    • 如需更多帮助，请与支持专家联系。

  • 无法解封创建术语库元数据。

    • 重试请求。
    • 如需更多帮助，请与支持专家联系。

  • 无法解压缩创建术语库规范。

    • 重试请求。
    • 如需更多帮助，请与支持专家联系。

  • 未能为翻译服务创建数据库事务。

    • 未能创建用于存储术语库的数据库。
    • 验证数据库服务状态，然后重启翻译服务器。

  • 未能为翻译服务创建表。

    • 未能创建用于存储术语库条目的翻译表。
    • 验证数据库服务状态，然后重启翻译服务器。

  • 词汇表不存在。

    • 翻译词库的必需表不存在。
    • 重新启动服务器将重试表创建。

  • S3 服务器证书不能为空。

    • 连接到 StorageGrid 所需的信息未正确填充到翻译服务器。
    • 验证 StorageGrid 的状态，然后重启翻译服务器。
    • 如需更多帮助，请与支持专家联系。

  • S3 访问 ID 不能为空。

    • 连接到 StorageGrid 所需的信息未正确填充到翻译服务器。
    • 验证 StorageGrid 的状态，然后重启翻译服务器。
    • 如需更多帮助，请与支持专家联系。

  • S3 访问密钥不能为空。

    • 连接到 StorageGrid 所需的信息未正确填充到翻译服务器。
    • 验证 StorageGrid 的状态，然后重启翻译服务器。
    • 如需更多帮助，请与支持专家联系。

AITR2134 - JobInternal

错误消息示例：

  • 无法更新已完成的作业。

  • 未能将作业设置为处理状态。

    • 针对作业记录的读取或写入操作失败，原因是数据库事务失败。
    • 重试请求。
    • 如需更多帮助，请与支持专家联系。

  • 无法更新已完成的作业。

  • 未能查询或运行 async 操作。

    • 由于以下原因之一，无法查询或更新 async 操作：
      • 数据库连接问题。
      • 数据无效，无法解析为响应。
    • 重试请求。
    • 如需更多帮助，请与支持专家联系。

  • 未能读取作业。

    • 由于数据库事务失败，针对作业记录的读取或写入操作失败。
    • 重试请求。
    • 如需更多帮助，请与支持专家联系。

  • 未能从数据库中删除作业。

    • 由于数据库事务失败，针对作业记录的读取或写入操作失败。
    • 重试请求。
    • 如需更多帮助，请与支持专家联系。

  • 返回多个具有相同 job_id 的作业。

    • 检查您的数据库，确保每个 job_id 都只出现一次。
    • 如需更多帮助，请与支持专家联系。

AITR2135 - DetectLanguageInternal

错误消息示例：

  • 检测语言结果缺失。
    • 语言检测器无法识别输入内容的语言。
    • 检查请求中的内容；验证字符是否有效，以及所有字词是否都使用同一种语言。
    • 重试请求。
    • 如需更多帮助，请与支持专家联系。

AITR2140 - TranslationServiceUnavailable

翻译服务不可用。