You need to enable JavaScript to run this app. 基于Express、Jest、Supertest的端点测试404及data未定义问题修复
优惠活动
大模型
产品
解决方案
定价
更多

基于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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.10.27 20:54:03