You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

React项目生产环境执行npm run build:prod报错,无法找到绝对路径模块

问题描述

我在React项目中做了如下配置:

jsconfig.json

{
  "compilerOptions": {
    "baseUrl": "src",
    "paths": {
      "*": ["src/*"]
    }
  }
}

package.json

"scripts": {
  "start:dev": "PORT=8000  env-cmd -e development react-scripts start",
  "start:prod": "PORT=8000 env-cmd -e production react-scripts start",
  "build:dev": "env-cmd -e development  react-scripts build",
  "build:prod": "env-cmd -e production  react-scripts build",
  "test": "react-scripts test",
  "eject": "react-scripts eject"
}

执行npm run build:prod进行生产环境构建时,遇到如下错误:

Failed to compile.
./src/index.js
Cannot find module: ‘context/SidebarContext’. Make sure this package is installed.
You can install this package by running: npm install context/SidebarContext.

但开发环境运行项目时并未出现该问题,恳请指导如何解决。

解决方案
  • 优化jsconfig.json路径配置
    你当前的paths配置"*": ["src/*"]和baseUrl: "src"存在冗余,反而可能让构建工具的路径解析逻辑混乱。修改为以下简洁配置即可:

    {
      "compilerOptions": {
        "baseUrl": "src"
      }
    }
    

    配置后依然可以直接使用import SidebarContext from 'context/SidebarContext'这类路径写法。

  • 核对文件大小写一致性
    开发环境(比如macOS系统)的文件系统通常大小写不敏感,但生产构建环节(尤其是基于Linux环境的构建流程)会严格区分大小写。检查你实际的文件路径是context/SidebarContext.js还是Context/SidebarContext.js,确保import语句里的路径大小写和实际文件完全匹配。

  • 排查环境配置文件干扰
    检查.env.production文件中是否存在NODE_PATH这类会影响模块解析的变量,这类变量可能会覆盖jsconfig.json的配置,导致生产构建时路径解析异常。

  • 清理缓存后重新构建
    React构建缓存可能导致读取旧的配置信息,执行以下命令清理缓存后再尝试构建:

    rm -rf node_modules/.cache
    npm run build:prod
    
  • 确认文件存在性与路径准确性
    检查src/context/SidebarContext.js(或对应扩展名如.tsx)是否真实存在,没有被误删除或移动位置。如果文件实际在src/contexts/目录下,需要同步修改import路径为contexts/SidebarContext。

内容的提问来源于stack exchange,提问作者Hemendra Mehta

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.07.28 02:13:31