基于Express、Jest、Supertest的端点测试404及data未定义问题修复
问题修复方案
一、async/await 改写后 ReferenceError: data is not defined 修复
该报错的核心原因是改写路由时,没有正确把fs.readFile的读取结果赋值给data变量,常见的错误写法包括:
- 漏写
const data = await readFile(...)的赋值语句,直接在后续逻辑中使用未定义的data - 错误地把
data定义在.then()回调的作用域内,却在回调外部引用data,导致作用域查找失败
正确的async形式通配路由写法参考:
const path = require('path') const fs = require('fs') const util = require('util') const readFile = util.promisify(fs.readFile) const convertData = require('./your-convert-module') // 自定义的markdown转HTML模块 // 注册通配路由 app.get('/*', async (req, res) => { try { // 1. 用await接住文件读取的结果,在当前作用域显式定义data变量 const mdPath = path.join(__dirname, 'content', req.path, 'index.md') const data = await readFile(mdPath, 'utf8') // 2. 正常处理内容渲染逻辑 const renderedContent = convertData(data) const template = await readFile(path.join(__dirname, 'template.html'), 'utf8') const finalHtml = template.replace('{{content}}', renderedContent) // 3. 读取成功返回200状态码 res.status(200).send(finalHtml) } catch (err) { // 捕获所有读取异常,文件不存在时返回404 if (err.code === 'ENOENT') { return res.status(404).send('Page Not Found') } // 其他服务异常返回500 res.status(500).send('Internal Server Error') } })
二、测试始终返回404的排查与修复
测试返回404和路由是否使用async/await语法没有关系,supertest原生支持async形式的Express路由,404问题基本来自以下几个常见场景:
- 请求路径使用错误:测试时直接把路由的通配符
/*当作请求地址发起,而不是使用实际存在的合法路径(如/about-page、/jobs),导致路由解析时尝试读取不存在的content/*/index.md文件,触发404返回 - 路径拼接逻辑错误:拼接文件路径时漏写层级,比如固定读取content根目录的index.md,没有把请求路径拼接到文件路径中,导致所有请求都因为找不到目标文件返回404
- app实例导出时机错误:在路由还未完成注册时就导出了app实例,测试引入的是没有挂载任何路由的空实例,所有请求自然匹配不到路由返回404
- 相对路径引发的文件找不到:拼接content文件夹路径时使用了相对路径(如
./content),当测试运行的工作目录和本地开发目录不一致时,会因为找不到content文件夹下的index.md文件返回404,所有文件路径拼接建议使用path.join(__dirname, ...)基于当前文件的绝对路径做拼接,避免工作目录差异的影响
正确的测试用例参考:
const request = require('supertest') const app = require('./app') describe('路径访问状态码校验', () => { it('访问真实存在的/about-page路径应返回200', async () => { // 注意:这里请求的是实际存在的合法路径,不是/*通配符 const response = await request(app).get('/about-page') expect(response.statusCode).toBe(200) }) it('访问真实存在的/jobs路径应返回200', async () => { const response = await request(app).get('/jobs') expect(response.statusCode).toBe(200) }) it('访问不存在的路径应返回404', async () => { const response = await request(app).get('/not-exist-page') expect(response.statusCode).toBe(404) }) })
内容的提问来源于stack exchange,提问作者randhm
相关产品推荐
相关产品推荐

