使用Google Cloud匹配引擎私有端点时restricts属性未正常存储

• Match接口未显式指定返回元数据
  匹配引擎的match接口默认不会返回存储的restricts元数据，必须在调用时显式开启返回开关。比如调用REST API时，要在请求体中添加"returnRestricts": true；如果用客户端SDK，要设置对应的参数（如Python SDK中的return_restricts=True），否则服务不会返回该字段。

• Upsert请求的restricts格式不符合规范
  即使你认为配置正确，也可能存在格式错误导致元数据未被存储：

  • 必须以数组形式传递restricts，每个元素包含namespace和allow/deny字段，示例格式如下：

    "restricts": [
      {"namespace": "color", "allow": ["red", "blue"]},
      {"namespace": "size", "allow": ["M", "L"]}
    ]
    

  • 检查字段拼写，比如把namespace误写为name，或者allow/deny字段名错误，都会导致元数据无法被正确存储，最终返回None。

• 索引配置未启用元数据存储
  检查匹配引擎的索引配置，确认是否开启了元数据存储功能。如果创建索引时未配置允许存储restricts元数据，即使upsert时上传了相关内容，服务也不会保存，后续查询自然返回None。需要核对索引创建时的参数，确保元数据存储选项已正确设置。

• VPC环境下的请求参数丢失
  由于是在VPC内部署，可能存在VPC内代理、防火墙或网络策略修改请求参数的情况。可以在相同VPC环境下，直接验证upsert请求的返回结果，确认restricts是否被服务正确接收；也可以使用gcloud命令行工具测试，排查是否是网络层面导致参数丢失。

内容的提问来源于stack exchange，提问作者Chrispresso