SalesForce SOSL通过REST查询关联对象：Case与Contact查询报错求助

没问题，我来帮你解决这个Salesforce REST API调用SOSL的问题！首先明确回答你：完全可以通过REST API调用SOSL来实现你的需求，但你当前的查询语句存在写法问题，这才导致了"Bind variables only allowed in Apex code"的错误。

错误原因分析 #

你遇到的错误提示看起来是绑定变量的问题，但本质是：在直接通过REST API调用的原生SOSL中，不允许在RETURNING子句的某个对象过滤条件里直接引用另一个返回对象的字段（比如你写的Contact(Email WHERE Id = Case.OwnerId)）。这种跨对象字段关联的写法，只有在Apex类中执行SOSL时才被支持，原生REST API的SOSL不兼容这种语法。

两种解决方案 #

方案1：拆分查询（无需Apex，快速实现）

这种方法不需要写任何Apex代码，通过两次REST API调用完成关联：

• 第一步：调用SOSL搜索目标Case，获取匹配记录的OwnerId
  使用以下SOSL语句，通过/services/data/vXX.X/search端点执行：

  find {XY00001234*} IN ALL FIELDS RETURNING Case(Id, ContactEmail, OwnerId WHERE ContactEmail LIKE '%.test') LIMIT 10
  

  从返回结果中提取所有匹配Case的OwnerId列表。
• 第二步：用提取到的OwnerId查询对应的Contact
  使用以下SOQL语句，通过/services/data/vXX.X/query端点执行：

  SELECT Id, Email, Name FROM Contact WHERE Id IN ('005XXXXXXXXXXXX', '005YYYYYYYYYYYY', ...)
  

  把第一步得到的所有OwnerId替换到IN子句中，就能拿到关联的Contact信息。

方案2：封装Apex REST服务（一次调用完成）

如果你希望通过单次API调用完成需求，可以写一个自定义Apex REST类，利用Apex支持SOSL跨对象绑定的特性来实现：

示例Apex代码：

@RestResource(urlMapping='/CaseContactSearch/*')
global with sharing class CaseContactSearchController {
    @HttpGet
    global static List<CaseWithContact> searchCaseAndContact() {
        String searchTerm = RestContext.request.params.get('searchTerm');
        List<CaseWithContact> results = new List<CaseWithContact>();
        
        // 在Apex中执行支持跨对象关联的SOSL
        List<List<SObject>> soslResults = [
            find :searchTerm IN ALL FIELDS 
            RETURNING Case(Id, ContactEmail, OwnerId WHERE ContactEmail LIKE '%.test'),
            Contact(Id, Email, Name WHERE Id = Case.OwnerId)
            LIMIT 10
        ];
        
        List<Case> cases = (List<Case>)soslResults[0];
        List<Contact> contacts = (List<Contact>)soslResults[1];
        
        // 整合Case和Contact数据，方便前端使用
        Map<Id, Contact> contactMap = new Map<Id, Contact>(contacts);
        for(Case c : cases) {
            CaseWithContact result = new CaseWithContact();
            result.caseRecord = c;
            result.contactRecord = contactMap.get(c.OwnerId);
            results.add(result);
        }
        
        return results;
    }
    
    // 定义返回的整合数据结构
    global class CaseWithContact {
        public Case caseRecord {get; set;}
        public Contact contactRecord {get; set;}
    }
}

部署这个类后，你就可以通过以下REST请求调用：

GET /services/data/v59.0/CaseContactSearch?searchTerm=XY00001234*

（注意替换v59.0为你使用的Salesforce API版本），一次请求就能拿到关联的Case和Contact信息。

小提示 #

• 方案1适合没有Apex开发权限的场景，实现简单但需要两次调用；
• 方案2逻辑更紧凑，一次调用完成，但需要你有Apex类的创建和部署权限；
• 无论哪种方案，都要确保API调用的用户拥有Case和Contact对象的查询权限。

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