Windows环境执行npm build遇UnhandledSchemeError问题求助

数据老陈

2026-6-12

Webpack构建报错：UnhandledSchemeError（Windows环境）

错误信息

ERROR in C:Userschinnap1mdc-scorecardappsmfesrcindex.tsx
Module build failed: UnhandledSchemeError: Reading from "C:Userschinnap1mdc-testappsmfesrcindex.tsx" is not handled by plugins (Unhandled scheme).
Webpack supports "data:" and "file:" URIs by default.
You may need an additional plugin to handle "c:" URIs.
at C:\Users\chinnap1\mdc-scorecard\node_modules\webpack\lib\NormalModule.js:1013:10
at Hook.eval [as callAsync] (eval at create (C:\Users\chinnap1\mdc-scorecard\node_modules\tapable\lib\HookCodeFactory.js:33:10), :6:1)

问题原因

Windows环境下，Webpack将C:开头的路径识别成了URI scheme（类似http:、data:），而非本地文件路径，而Webpack默认仅支持data:和file:两种scheme，因此抛出未处理错误。

解决方法

规范webpack配置中的路径写法
避免直接硬编码Windows绝对路径，使用Node.js的path.resolve()方法生成正确的绝对路径，确保Webpack识别为本地文件。示例：
```
const path = require('path');

module.exports = {
  entry: path.resolve(__dirname, 'apps/mfe/src/index.tsx'),
  // 其他配置项...
};
```
替换代码中的硬编码绝对路径
检查项目中所有导入语句，将C:\Users\chinnap1\...这类绝对路径替换为相对路径（如./index.tsx、../components/xxx.tsx），让Webpack按模块解析规则处理。
配置资源文件处理规则
如果是图片、字体等资源文件使用了绝对路径导入，可配置Webpack 5内置的asset/resource替代第三方loader：
```
module.exports = {
  module: {
    rules: [
      {
        test: /\.(png|jpe?g|gif|svg|woff2?)$/,
        type: 'asset/resource',
      },
    ],
  },
};
```
升级Webpack版本
旧版Webpack在Windows路径解析上存在兼容性问题，升级到最新稳定版（如Webpack 5.x）可修复部分路径识别bug。