Failed to load resource: the server responded with a status of 404 (Not Found) node.js开发微信小程序

### 解决 Node.js 开发微信小程序时遇到的 404 资源未找到错误

#### 页面路径配置不正确
当在 `app.json` 中定义的小程序页面路径不存在或拼写错误时，会触发此错误。确保所有页面路径已正确定义并存在于项目的 pages 文件夹下[^1]。

{
  "pages":[
    "pages/index/index",
    "pages/logs/logs"
  ]
}

#### NPM 包管理问题
如果依赖项缺失或未能成功安装到 `node_modules` 目录，则可能导致静态资源加载失败。确认 `package.json` 已经更新，并且通过构建 npm 正确处理了这些依赖关系[^3]：

修改 `project.config.json` 如下所示：

{
  ...
  "packNpmManually": true,
  "packNpmRelationList": [
    {
      "packageJsonPath": "./package.json",
      "miniprogramNpmDistDir": "./dist"
    }
  ],
  ...
}

执行命令来安装必要的模块：

npm install

然后点击开发者工具中的“构建 npm”。

#### 静态资源引用不当
对于图片或其他媒体文件，应采用相对 URL 或者绝对 URL 来引用它们；避免硬编码路径，因为不同环境下的根目录可能有所差异。例如，在 WXML 文件里可以像下面这样做：

<image src="/static/images/logo.png"></image>

同时也要注意检查服务器端设置是否允许跨域资源共享(CORS)，特别是在使用外部 CDN 主机托管资源的情况下。

#### 异步操作影响
某些情况下，由于异步任务的原因可能会导致页面初始化出现问题。可以通过 promise 方式优化 API 请求逻辑，减少此类风险[^2]:

// app.js
import { promisifyAll } from 'miniprogram-api-promise';
const wxp = {};
promisifyAll(wx, wxp);