在浏览器环境中使用 ES Module 导入 JavaScript 模块时，遇到 net::ERR_ABORTED 404 (Not Found) 错误是常见问题。本文旨在提供一份全面的教程，帮助开发者诊断并解决此类错误，主要聚焦于模块路径配置、文件命名、服务器环境以及浏览器缓存等关键因素，确保模块能够正确加载和运行。

理解 net::ERR_ABORTED 404 (Not Found) 错误

当浏览器尝试通过

常见原因与解决方案

解决 404 错误的关键在于系统性地排查可能的问题点。

1. 模块路径配置错误

这是导致 404 错误最普遍的原因。JavaScript 模块的 import 语句中的路径必须精确地指向模块文件的位置。

• 相对路径与绝对路径：

  • 相对路径： 相对于当前导入文件的位置。
    • ./ 表示当前目录。例如，如果 test.js 和 octokit.js 在同一个目录下，应使用 import { Octokit } from "./octokit.js";。
    • ../ 表示上一级目录。例如，如果 octokit.js 在 js 文件夹中，而 test.js 在 html 文件夹中，且 js 和 html 是同级目录，那么 test.js 中导入 octokit.js 的路径可能是 ../js/octokit.js。
  • 绝对路径： 从网站根目录开始的路径，通常以 / 开头。例如，如果 octokit.js 位于网站根目录下的 modules 文件夹中，路径可能是 /modules/octokit.js。
  • 完整 URL： 也可以使用完整的 URL，例如 https://example.com/modules/octokit.js，但这在本地开发中较少使用，除非是从 CDN 导入。

• 文件扩展名： 在浏览器环境的 ES Module 导入中，通常需要明确指定 .js 文件扩展名。即使在 Node.js 环境中可以省略，但在浏览器中为了解析的明确性，强烈建议加上。

示例代码：

假设项目结构如下：

your-project/
├── index.html
├── test.js
└── octokit.js

index.html 内容：

    
    
    


    
Hello ES Module
    
    

test.js 内容：

// 确保 octokit.js 与 test.js 在同一目录下
// 正确的相对路径，包含 .js 扩展名
import { Octokit } from "./octokit.js"; 

const TOKEN = "mytoken"; // 实际应用中请勿硬编码敏感信息，此处仅为示例
const octokit = new Octokit({
    auth: TOKEN
});

console.log("Octokit loaded:", octokit);
// 可以在这里使用 octokit 实例进行 API 调用

注意事项：

• 仔细检查 import 语句中的路径是否与文件实际位置匹配。
• 确认文件扩展名 .js 已包含在路径中。

2. 文件命名或拼写错误

一个简单但容易被忽视的问题是文件名或路径中的拼写错误。例如，octokit.js 写成了 octokit.JS 或 octkit.js。文件系统对大小写敏感（尤其是在 Linux 或某些服务器上），因此请务必核对文件名。

3. 服务器环境配置

浏览器无法直接通过 file:// 协议加载 ES Module，这是出于安全考虑。你需要一个本地 Web 服务器来提供文件服务。

• 使用本地开发服务器：
  • 如果你使用 VS Code，Live Server 插件是一个非常方便的选择，它会在本地启动一个服务器（例如 http://127.0.0.1:5500），从而正确地解析和加载模块。
  • 其他工具如 http-server (Node.js 包)、Webpack Dev Server、Vite 等也提供类似功能。
• CORS (跨域资源共享)：
  • 如果你的模块文件是从不同的域（域名、协议或端口）加载的，可能会遇到 CORS 错误，导致浏览器阻止加载。尽管对于本地开发环境中的 404 错误，CORS 通常不是直接原因，但如果模块是从 CDN 或其他服务加载，且服务器未正确配置 CORS 头部，则可能出现此问题。在这种情况下，你需要确保提供模块的服务器允许你的开发域进行访问。

4. 浏览器缓存问题

有时，浏览器可能会缓存旧的或损坏的资源路径，导致即使路径已修正，仍然报告 404 错误。

• 清除浏览器缓存： 尝试清除浏览器缓存，特别是“禁用缓存”选项在开发者工具的网络面板中打开时。
• 使用无痕模式： 在无痕模式下测试，可以排除浏览器扩展和缓存的影响。

调试技巧

当遇到 404 错误时，利用浏览器开发者工具是最高效的诊断方法：

1. 打开开发者工具： 在 Chrome 中按 F12 或 Ctrl+Shift+I。
2. 切换到“网络 (Network)”面板： 刷新页面，观察请求列表。
3. 查找 404 状态码： 找到状态码为 404 Not Found 的请求。
4. 检查请求 URL： 点击该请求，查看其“请求 URL (Request URL)”详情。这个 URL 就是浏览器实际尝试加载的路径。将这个路径与你的文件系统中的实际路径进行对比，通常能发现问题所在。
5. 检查“控制台 (Console)”面板： 有时，即使不是 404 错误，控制台也会显示其他与模块加载相关的错误信息，例如 Uncaught TypeError: Failed to resolve module specifier。

总结

net::ERR_ABORTED 404 (Not Found) 错误在 ES Module 导入中，绝大多数情况下是由于模块路径不正确或文件不存在造成的。通过仔细检查 import 路径（包括文件扩展名和相对/绝对定位）、确认文件名拼写、确保在本地开发服务器上运行代码，并善用浏览器开发者工具进行调试，可以高效地定位并解决这类问题。记住，清晰的项目结构和规范的模块路径是避免此类错误的最佳实践。