异步单元测试JSON.parse报错但控制台运行正常的排查与修复
Serverless新建笔记API单测JSON解析报错问题排查
问题背景
- 学习Serverless Stack示例过程中边开发边编写测试,当前正在为新建笔记API章节对应的
create.js文件编写单元测试 - 运行测试时暂未添加完整断言逻辑,代码执行到
JSON.parse(event.body)位置就抛出错误:Unexpected token u in JSON at position 0
关联代码
测试代码 create.test.js
import * as create from '../create.js'; test('create', async () => { const event = JSON.stringify({'body': 'event'}); // 等价入参示例: '{ "body": "test" }' const context = 'context'; const callback = (error, response) => { expect(response.statusCode).toEqual(200); }; await create.main(event, context, callback); });
被测业务代码 create.js
import * as uuid from "uuid"; import AWS from "aws-sdk"; const dynamoDb = new AWS.DynamoDB.DocumentClient(); export async function main(event, context) { // 请求体以JSON编码字符串形式存放在'event.body'中 const data = JSON.parse(event.body); const params = { TableName: process.env.tableName, Item: { // 待创建条目的属性 userId: "123", // 作者ID noteId: uuid.v1(), // 生成唯一UUID content: data.content, // 从请求体解析获取 attachment: data.attachment, // 从请求体解析获取 createdAt: Date.now(), // 当前Unix时间戳 }, }; try { await dynamoDb.put(params).promise(); return { statusCode: 200, body: JSON.stringify(params.Item), }; } catch (e) { return { statusCode: 500, body: JSON.stringify({ error: e.message }), }; } }
已完成的排查操作
- 移除业务代码中的
JSON.parse逻辑后,测试可以正常运行 - 在控制台执行
JSON.parse(JSON.stringify({'body': 'event'})),逻辑运行完全正常
报错根因
- 测试代码构造的
event参数类型不符合业务预期:main函数需要接收结构化JS对象类型的event,测试时却把event对象整体序列化成了JSON字符串再传入 - 字符串类型的
event不存在body属性,函数内部读取event.body时得到的值是undefined - 执行
JSON.parse(undefined)就会触发指定报错,报错信息里的字符u,正是undefined字符串化后的首字符 - 控制台验证逻辑和实际运行逻辑不一致:控制台是把整个包含body的对象序列化后再整体解析,实际代码是从传入的event对象上读取body字段,不存在二次解析整个event的逻辑
调整方案
修改测试代码中event的构造逻辑,让传入的参数和真实API网关触发的Lambda事件结构保持一致:
- 去掉对
event整体的JSON.stringify处理,直接传入结构化对象 - 给
event.body字段赋值为合法的序列化JSON字符串(和业务代码JSON.parse的解析预期匹配)
调整后的测试代码核心片段:
test('create', async () => { // 构造和真实结构一致的event对象 const event = { body: JSON.stringify({ content: "测试笔记内容", attachment: "测试附件地址" }) }; const context = 'context'; const callback = (error, response) => { expect(response.statusCode).toEqual(200); }; await create.main(event, context, callback); });
内容的提问来源于stack exchange,提问作者Jules。
相关产品推荐
相关产品推荐

