在IntelliJ中使用Karate运行GraphQL测试时出现JSON解析错误
问题根因定位
本次报错的核心触发点有两个:
- 脚本里用
def关键字搭配三引号块存GraphQL查询语句时,Karate会优先调用内置的net.minidevJSON解析器把块内容转换为JSON对象。但GraphQL查询语法本身不属于合法JSON范畴:比如GraphQL支持无引号的对象键名、带参数的字段调用(如count(uniq: callers)、startOfInterval(unit: day)),这些结构完全不符合JSON语法规范,解析器读到位置181的非法字符时就会抛出ParseException。需要特别注意:Karate在三引号块JSON解析失败时,不会自动降级为纯字符串存储,会直接终止流程抛错。 - 就算解决了JSON解析报错,当前脚本的请求逻辑也不符合GraphQL接口规范:用GET方法发请求、直接把GraphQL语句作为请求体的写法,完全无法被Bitquery的GraphQL接口正确识别,后续依然会返回调用失败。
排查与解决步骤
1. 修正纯文本变量定义,跳过自动JSON解析
不要用def关键字存储GraphQL这类非JSON格式的纯文本内容,改用Karate内置的text关键字定义变量。text关键字的作用是直接把三引号块的内容作为纯字符串存储,全程不触发JSON语法校验,从根源上避免解析报错:
# 用text代替def,直接将GraphQL存为纯字符串 * text graphqlQuery = """ { ethereum { smartContractEvents(options: {desc: "date.date"}, smartContractAddress: {is: "0x00000000219ab540356cbb839cbe05303d7705fa"}, date: {since: "2019-01-01", till: null}) { date { date: startOfInterval(unit: day) } smartContractEvent { __typename name } times: count uniqueCallers: count(uniq: callers) } } } """
如果使用的Karate版本低于0.9.5,没有内置text关键字,可以通过字符串拼接的方式绕过自动JSON解析:
* def graphqlQuery = '' + ''' { 你的GraphQL查询内容 } '''
2. 按照GraphQL接口规范修正请求逻辑
Bitquery的GraphQL接口要求以POST方法发送请求,请求头指定Content-Type: application/json,请求体必须封装为标准GraphQL结构{"query": "完整GraphQL查询文本", "variables": {}},不能直接把GraphQL原文作为请求体发送。
修正后的请求逻辑如下:
Given url 'https://graphql.bitquery.io' And header Content-Type = 'application/json' # 封装符合规范的GraphQL请求体 And request { query: '#(graphqlQuery)', variables: {} } When method post Then status 200 And print response
排错验证要点
- 变量内容验证:在定义完
graphqlQuery后加一步* print graphqlQuery,确认控制台打印的是完整无截断的GraphQL文本,没有出现JSON语法转义或者解析残留 - 查询有效性验证:把打印出来的GraphQL语句单独放到Bitquery的GraphQL调试环境跑通,确认查询本身没有逻辑或语法错误,再回到Karate脚本执行
- 避坑提醒:只要涉及非JSON格式的纯文本存储,优先用
text关键字定义变量,不要依赖def的自动类型转换,避免触发JSON解析异常
内容的提问来源于stack exchange,提问作者achyuth pydmarri
相关产品推荐
相关产品推荐

