You need to enable JavaScript to run this app. 在IntelliJ中使用Karate运行GraphQL测试时出现JSON解析错误
优惠活动
大模型
产品
解决方案
定价
更多

在IntelliJ中使用Karate运行GraphQL测试时出现JSON解析错误

问题根因定位

本次报错的核心触发点有两个:

  • 脚本里用def关键字搭配三引号块存GraphQL查询语句时,Karate会优先调用内置的net.minidev JSON解析器把块内容转换为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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.15 05:24:01