当前位置：首页 > news >正文

【问题】使用腾讯宝塔部署并启动Nodejs应用异常处理Cannot find module ‘express‘

news 2025/9/17 9:01:46

遇到 Error: Cannot find module 'express' 这个问题确实让人头疼，这通常意味着Node.js在运行你的项目时找不到所需的express模块。别担心，我们可以按照以下步骤来排查和解决。

首先，给你一个快速的解决流程图，帮助你理清思路：

flowchart TDA[启动Node项目报错
Cannot find module 'express'] --> B[通过SSH连接服务器
并进入项目根目录]B --> C{检查项目根目录下
是否存在node_modules文件夹}C -- 存在 --> D[删除node_modules文件夹
和package-lock.json]C -- 不存在 --> E[直接执行npm install]D --> EE --> F[再次运行项目]F --> G{问题是否解决?}G -- 未解决 --> H[检查package.json中
dependencies是否包含express]H --> I[手动安装express: npm install express]I --> J[重启项目]

下面是详细的解决步骤：

🔍 1. 确保在项目根目录安装依赖

这是最常见的原因。Node.js模块需要安装在项目根目录（即包含package.json的目录），全局安装或安装路径错误都会导致模块找不到。

通过SSH连接到你的腾讯云服务器。
进入你的项目根目录。根据错误信息，你的项目路径是 /www/wwwroot/deploy/markdown_to/。
```
cd /www/wwwroot/deploy/markdown_to/
```
检查当前目录，确保你正在项目根目录下操作（通常有 package.json、src 等文件和文件夹）。
安装所有依赖。在项目根目录下执行：
```
npm install
```
这个命令会根据 package.json 中的 dependencies 列表安装所有必需的包，包括 express。

📦 2. 检查并确认Express依赖项

有时，package.json 文件可能遗漏了 express，导致 npm install 没有安装它。

**检查 package.json**：
```
cat package.json
```
查看 dependencies 部分是否包含 "express"。
如果缺少express，你需要手动安装并将其添加到依赖中：
```
npm install express --save
```
--save 参数会自动将 express 及其版本信息添加到 package.json 的 dependencies 中。

🧹 3. 清理缓存并重新安装

如果上述步骤后问题依旧，可能是缓存或部分安装损坏所致。

强制清理npm缓存：
```
npm cache clean --force
```
删除 node_modules 文件夹和 package-lock.json (注意： 此操作会删除所有已安装的包，但接下来会重新安装)：
```
rm -rf node_modules package-lock.json
```
重新完整安装所有依赖：
```
npm install
```

⚙️ 4. 检查宝塔面板中的Node项目配置

如果你是通过宝塔面板的“网站”->“Node项目”功能来部署和启动的，请检查：

项目路径：是否正确设置为项目的根目录（/www/wwwroot/deploy/markdown_to/）。
启动文件选项：是否正确指向你的入口文件（例如 src/server.js）。
确保这些配置准确无误，因为宝塔会根据这些设置来寻找 node_modules。

🔄 5. 其他排查点

Node.js版本兼容性：虽然可能性相对较低，但仍需确保你项目中的express版本与服务器上的Node.js版本（v22.19.0）是兼容的。你可以查阅https://expressjs.com/或其NPM页面来确认版本支持情况。
模块导入语法：检查你的代码（如 src/server.js），确保导入express的语法是正确的CommonJS语法（因为你使用的是require）：
```
// 确保是这样写的
const express = require('express');
// 而不是ES6的import语法
// import express from 'express';
```
对于用CommonJS编写的Express.js，应使用require来导入。