Webpack v4迁移v5后同构应用自定义入口无法解析'./src'的调试方法

1. 先确认入口路径与上下文匹配 #

• 检查webpack配置里的context字段：v5对路径上下文的校验更严格，如果没显式设置，默认以配置文件所在目录为基准。比如你的webpack配置在config/子目录，写./src/client.js就会指向config/src/client.js，这时候要么改成../src/client.js，要么加context: path.resolve(__dirname, '../')（记得引入node的path模块）。
• 直接打印绝对路径验证：在配置文件里加一行console.log(path.resolve(__dirname, './src/client.js'))，运行webpack看输出的路径是不是你实际文件的位置，排除拼写错误。

2. 排查resolve配置的细节 #

• 虽然你已经配置了extensions，还是要确认顺序：把.js放在最前面，比如extensions: ['.js', '.jsx', '.json']，避免优先级问题导致解析不到文件。
• 检查resolve.modules：v5默认只找node_modules，如果想把src当作模块根目录，得把它加到数组里：

  resolve: {
    modules: [path.resolve(__dirname, 'src'), 'node_modules']
  }
  

  这步能辅助排查是否是模块根目录的问题。

3. 开启解析日志找线索 #

• 运行webpack时加--debug-resolve参数，或者在配置里设置stats: 'verbose'，这样能看到webpack解析每个模块的完整过程，比如它尝试解析./src时的所有候选路径，对比实际文件位置就能找到问题点。

4. 检查环境变量与条件配置 #

• 如果你的配置区分了客户端/服务端环境，确认入口路径有没有被环境变量错误覆盖。比如写了entry: process.env.NODE_ENV === 'server' ? './src/server.js' : './src/client.js'，要确保环境变量取值正确。
• 排查是否有插件（比如EnvironmentPlugin）修改了路径相关的变量，导致解析出错。

5. 清理缓存与依赖配置 #

• v5的缓存机制更严格，试试删除node_modules/.cache/webpack目录，或者运行webpack时加--no-cache，避免旧缓存干扰。
• 检查项目根目录的package.json里有没有exports字段，v5会优先读取这个字段，如果exports没配置指向src的规则，可能导致解析失败，不需要的话直接删掉这个字段就行。

6. 用最小配置定位问题 #

• 把webpack配置简化到最简：只保留入口、output和基础resolve配置，去掉所有插件和额外规则，看是否还会报错。如果能，逐步加回配置项，找到触发错误的部分；如果不能，说明是某个插件或规则和v5不兼容。

内容的提问来源于stack exchange，提问作者Sufyan Mahmood