Groovy调用Graph API时$filter失效返回全部用户问题排查

这个问题我之前也碰到过，核心原因是Groovy对Map键的解析逻辑和你预期的不一样，导致$filter参数根本没被正确传递给Graph API，所以接口返回了全部用户。

为什么过滤会失效？ #

看你代码里的query参数写法：

query:[ $filter:"mail eq '$userEmail'" ]

Groovy里$是变量插值的符号，当你直接写$filter作为Map的键时，Groovy会把它当成变量名去查找，而不是字符串"$filter"。如果你的代码里没定义过名为$filter的变量，这个键会被Groovy直接忽略，最终发送的请求里完全没有$filter查询参数——这就是Graph API返回所有用户的原因。

修复方法 #

给$filter这个键加上单引号（或双引号），明确告诉Groovy这是一个字符串键，不是变量：

public String getUserIdByEmailQuery(String AuthToken,String userEmail){
 String _ret
// 去掉多余的"?", HTTPBuilder会自动处理query参数的拼接
 def http = new HTTPBuilder(graph_base_user_url)
 http.request(GET) {
 requestContentType = ContentType.JSON
// 用单引号包裹$filter键，确保它被解析为字符串
 query:[ '$filter':"mail eq '$userEmail'" ]
 headers.'Authorization' = "Bearer " + AuthToken
 response.success = { resp, json -> 
 _ret = json
 }
 response.'404' = { resp -> 
 _ret = 'Not Found'
 }
 }
 _ret
}

额外优化提示 #

1. 去掉了graph_base_user_url +"?"的手动拼接，HTTPBuilder会自动把query参数拼接到URL末尾，避免手动拼接可能出现的格式问题。
2. 如果你的userEmail可能包含特殊字符（比如单引号），建议用参数绑定或者转义处理，避免Graph API的过滤语法出错。

修改后，发送的请求URL会和你在Postman里的完全一致：https://graph.microsoft.com/v1.0/users?$filter=mail eq 'myuser@hotmail.com'，就能正确返回过滤后的用户了。

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