如果您在配置本教程时遇到问题，本页列出了您可能会遇到的问题，并提供了有关如何解决每个问题的建议。
缺少 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 Commerce，或者该服务已停用
尝试运行教程时，会出现以下错误：
PERMISSION_DENIED: Vertex AI Search for commerce API has not been used in project <YOUR-PROJECT-ID> before or it is disabled
如需解决此问题，请在 Google Cloud 控制台的 API/服务详情页面上启用 Vertex AI Search for Commerce，或运行以下命令：
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确保服务账号处于活跃状态。 设置环境变量：
- 对于所有语言，请运行以下命令：
export GOOGLE_APPLICATION_CREDENTIALS=~/key.json- 对于 .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 并从头开始运行教程。