排查教程问题

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

缺少 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 消息。空文件表示密钥创建过程中出错。如果缺少文件，则表示错误发生在之前。 如需解决此问题，请按照“准备工作环境”教程步骤操作。

AI Commerce Search 之前未用于此项目，或者已停用

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

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

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

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 或打开新的终端窗口后，您可能会看到此错误。

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

  1. 按照“准备工作环境”教程中的步骤操作，并通过运行 gcloud auth list 确保服务账号处于有效状态。

  2. 设置环境变量：

    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 并从头开始运行教程。