SOQL查询Salesforce ContentNote.Content返回URL的规避方案咨询

安全阿岳

2026-9-28

问题原因

SOQL 查询 Salesforce 中 blob 类型字段时，默认不会直接返回字段的二进制内容，只会返回对应的资源访问 URL。ContentNote 的 Content 字段属于 blob 类型，因此会出现你遇到的返回 URL 而非富文本内容的情况。

可行规避方案

方案1：关联查询ContentVersion，一次获取全部内容（最优）
ContentNote 本质是 Salesforce 增强笔记类型的特殊封装，对应 ContentVersion 对象中 FileType = 'SNOTE' 且为最新版本的记录。直接查询 ContentVersion 可一次拿到所有富文本内容，完全规避N+1问题。
参考SOQL：

SELECT Id, ContentDocumentId, VersionData, TextPreview 
FROM ContentVersion 
WHERE FileType = 'SNOTE' AND IsLatest = true
LIMIT 100

返回结果中 VersionData 字段即为原 ContentNote.Content 对应的base64编码富文本内容，直接解码即可使用。

方案2：批量拉取blob内容，降低N+1请求损耗
如果必须直接查询ContentNote，可通过jsforce的批量blob拉取能力减少业务层代码复杂度，参考代码：

// 先查询ContentNote基础数据
const notes = await conn.sobject('ContentNote')
  .select('Id, TextPreview')
  .limit(100)
  .execute();

// 批量并行拉取Content字段内容
const notesWithContent = await Promise.all(
  notes.map(async note => {
    const contentBlob = await conn.sobject('ContentNote')
      .record(note.Id)
      .blob('Content');
    // 按需转base64或明文
    note.Content = contentBlob.toString('base64');
    return note;
  })
);