Salesforce元数据API：describe()比read()缺失大量字段的原因？

字段缺失的核心原因 #

这两个方法调用的是Salesforce完全不同的API，逻辑和权限控制差异极大：

• _sf.mdapi.CustomObject.read(sf_object_name) 调用Metadata API：直接读取Salesforce存储的对象元数据，只要你拥有Metadata API访问权限，就能拿到该对象所有已创建的字段——不管当前用户有没有字段级访问权限，哪怕字段处于未激活状态也能获取。
• getattr(_sf, sf_object_name).describe() 调用REST API的DescribeSObject端点：返回的是当前用户有权限访问的字段集合。如果你的账号没有某些字段的读权限，或字段被设置为隐藏、所属权限集未分配，这些字段就不会出现在describe结果里。

兼顾需求的解决方案 #

既然你偏好.describe()的picklist值返回格式，但又想拿到完整字段列表，可以试试以下方案：

1. 检查并提升用户权限：确保当前使用的Salesforce账号拥有目标对象所有字段的读权限，或给账号分配包含全字段访问的权限集/Profile。权限到位后，.describe()就能返回所有可访问字段（注意：未激活字段仍不会出现在结果中，因为这类字段本身不可用）。
2. 结合两种API的结果：用Metadata API拿到完整字段列表，再用describe的结果补全picklistValues等运行时属性。示例逻辑如下：

# 获取元数据层面的完整字段列表
md_fields = _sf.mdapi.CustomObject.read(sf_object_name).fields
# 获取用户可访问字段的describe结果
describe_result = getattr(_sf, sf_object_name).describe()
describe_fields = {f['name']: f for f in describe_result['fields']}

# 合并结果：保留所有元数据字段，补全describe里的picklist等信息
full_fields_with_picklists = []
for md_field in md_fields:
    field_name = md_field.fullName
    # 优先用describe的属性，没有则补元数据字段的基础信息
    combined_field = describe_fields.get(field_name, {})
    combined_field.update({'fullName': field_name, 'type': md_field.type})
    full_fields_with_picklists.append(combined_field)

3. 处理valueSetName的情况：如果Metadata API返回的是valueSetName，可以调用_sf.mdapi.ValueSet.read(value_set_name)获取对应的选择列表值，再和describe结果结合使用。

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