Salesforce对象可通过UI访问但API无法访问的问题求助

以下是针对你遇到的问题（同一用户通过UI能打开特定Account记录，但用API按ID查询却拿不到，且约三分之一对象有此问题）的实用排查方向：

• 核对API权限的细节设置
  别只看表面的全权限，要确认：

  • 账号的Profile或Permission Set里，不仅给了Account对象的Read权限，还得确保API Enabled选项已勾选；
  • 检查字段级权限：即使对象有访问权，如果Name字段的API访问权限没开，也可能导致查询异常（你可以先试试只查Id：SELECT Id FROM Account WHERE Id='0061n00000b5pEdAAI'，看是否能返回结果）。

• 排查共享规则与API访问上下文
  Salesforce的UI和API在共享规则应用上偶尔会有差异：

  • 确认是否有针对API访问的特殊共享设置，比如某些记录仅对UI访问开放；
  • 如果你用的是自定义API客户端，检查是否默认启用了With Sharing模式，导致部分共享规则限制了API的记录可见性。

• 验证查询语句的准确性

  • 确保ID完全匹配：UI URL里的是18位标准ID，API查询时别用15位短ID，避免因大小写或格式问题匹配失败；
  • 先去掉query_all，用基础的query方法测试：sf_client.query("SELECT Id, Name FROM Account WHERE Id='0061n00000b5pEdAAI'")，排除分页逻辑带来的干扰。

• 检查数据权限的特殊配置

  • 查看是否有数据分类或数据屏蔽规则，把部分标记的记录设置为仅UI可见，API无法读取；
  • 如果是Person Account类型，确认查询时是否需要指定特殊的筛选条件（不过UI能正常访问的话，这个概率不高）。

• 刷新权限缓存
  有时候权限设置更新后不会立即同步到API端：

  • 重新登录你的API客户端；
  • 在Salesforce后台的用户管理里，强制刷新该用户的权限缓存。

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