此页面由 Cloud Translation API 翻译。

排查教程问题

如果您在配置教程时遇到问题，本页面列出了您可能遇到的问题，并提供了关于如何解决每个问题的建议。

缺少 cloudshell_open 文件夹

如果您在运行 ls ~ 后在主目录中没有看到 cloudshell_open 文件夹，则该文件夹及其文件已丢失。如果您在暂存模式下使用 Cloud Shell 并断开互联网连接或刷新页面，就会出现此问题。如需解决此问题，请从头开始重新运行本教程。为避免日后丢失文件，请考虑切换到默认模式。

无法在当前环境中检测到项目 ID

当您尝试运行代码示例时，会出现以下错误：

ERROR Unable to detect a Project Id in the current environment.

如果未设置 Google Cloud 项目，就会出现此问题。如需解决此问题，请运行以下命令来设置项目：

gcloud config set project <YOUR-PROJECT-ID>

运行代码示例时出现的 key.json 错误

运行代码示例时会出现以下错误之一：

File /home/user/key.json is not a valid json file

no JSON input found

The file at /home/user/key.json does not exist, or it is not a file

Could not find file '/home/user/key.json'

Error reading credential file from location /home/user/key.json: Value cannot be null

当用于对服务账号进行身份验证的 key.json 文件为空或缺失时，就会出现此问题。您可以通过运行以下命令来确认是否存在这种情况：

cat ~/key.json

这将输出文件的内容或 No such file or directory 消息。空文件表示在创建密钥时发生了错误。如果缺少文件，则表示错误发生在该时间之前。如需解决此问题，请按照“准备工作环境”教程步骤操作。

项目中未使用过或已停用 Vertex AI Search for Retail

当您尝试运行教程时，会发生以下错误：

PERMISSION_DENIED: Vertex AI Search for retail API has not been used in project <YOUR-PROJECT-ID> before or it is disabled

如需解决此问题，请在 Google Cloud 控制台的 API/服务详情页面上启用 Vertex AI Search for Retail，或运行以下命令：

gcloud services enable \
    retail.googleapis.com \
    --project=<YOUR-PROJECT-ID>

服务账号无权访问项目实例

向服务账号分配角色时，发生以下错误：

User [USER@YOUR-PROJECT-ID.] does not have permission to access projects instance [YOUR-PROJECT-ID:setIamPolicy] (or it may not exist): Policy update access denied.

如需解决此问题，请在终端中运行 gcloud auth list 命令，检查您是否使用的是正确的有效账号。确保活跃账号是服务账号。前往 Google Cloud 控制台中的 IAM 页面，检查该服务账号是否为您的 Google Cloud 项目的所有者。

使用最终用户凭据进行的身份验证无效

运行代码示例时会出现以下错误：

PERMISSION_DENIED: Your application has been authenticated using end user credentials from the Google Cloud SDK or Google Cloud Shell which are not supported by the retail.googleapis.com.

如果使用最终用户凭据（而不是服务账号），就会出现此问题。如果服务账号处于非活动状态或未设置所需的环境变量，也可能会出现此问题。重启 Cloud Shell 或打开新的终端窗口后，您可能会看到此错误。

要解决此问题，请执行以下操作：

按照“准备好工作环境”中的说明操作执行教程步骤，并通过运行 gcloud auth list 确保服务账号处于活跃状态。
设置环境变量：
1. 对于所有语言，请运行以下命令：
```
export GOOGLE_APPLICATION_CREDENTIALS=~/key.json
```
1. 此外，对于 .NET，请运行以下命令：
```
export GOOGLE_PROJECT_ID=<YOUR-PROJECT-ID>
```

服务账号没有所需角色时出现权限错误

运行代码示例时，出现以下错误：

google.api_core.exceptions.PermissionDenied: 403 Permission 'retail.<YOUR-REQUEST>' denied on resource '//retail.googleapis.com/projects/<YOUR-PROJECT-ID>/locations/<YOUR-LOCATION>' (or it may not exist). [reason: "IAM_PERMISSION_DENIED"

如果您的服务账号没有所需的角色，则会发生此问题：Retail.admin 和 editor。如要解决此问题，请按照“准备工作环境”中的说明设置工作环境教程步骤。

搜索操作未返回任何匹配结果

如果目录中没有任何产品与您的搜索查询匹配，或者产品目录为空，就会出现此问题。如需解决此问题，请在 Google Cloud 控制台中的目录页面上检查您的目录中是否有商品。如果没有，请按照“导入目录数据”教程步骤导入目录数据。

仍然存在问题

请尝试重置 Cloud Shell，然后从头开始运行教程。