📌 背景
在 Debian 上使用以下命令创建了一个 Svelte 项目：
npm install -g sv
npx sv create my-svelte-demo
cd my-svelte-demo
npm install
npm run dev
现在需要将该项目迁移到一台 无法联网的 RHEL 9.4 服务器 上运行，出现如下报错：
Error [ERR_MODULE_NOT_FOUND]: Cannot find module '/path/to/node_modules/dist/node/cli.js'
❌ 错误原因分析
-
报错来自
npm run dev中的vite启动失败。 -
错误提示：
Cannot find module '.../node_modules/dist/node/cli.js' -
说明当前项目的
node_modules中的vite被破坏或软链接指向了错误路径（如迁移时损坏、部分依赖缺失）。
✅ 正确的迁移方案（推荐）
一、在 Debian 上重新打包项目（含依赖）
- 清理旧依赖并重新安装：
cd my-svelte-demo
rm -rf node_modules package-lock.json
npm install
- 检查 Vite 执行文件是否正确：
ls -l node_modules/.bin/vite
head -n 5 node_modules/.bin/vite
输出示例（✅ 正确）：
#!/usr/bin/env node
require('../vite/bin/vite.js');
- 打包整个项目（包含依赖）：
cd ..
tar -czvf my-svelte-demo.tar.gz my-svelte-demo/
二、在 RHEL 9.4 上准备运行环境
-
安装 Node.js（离线）
- 下载
.tar.xz版本 Node.js：
https://nodejs.org/en/download - 解压并配置环境变量（假设解压路径为
~/Softwares/nodejs）：
- 下载
tar -xf node-vXX.X.X-linux-x64.tar.xz
mv node-vXX.X.X-linux-x64 ~/Softwares/nodejs
echo 'export PATH=$HOME/Softwares/nodejs/bin:$PATH' >> ~/.bashrc
source ~/.bashrc
- 验证 Node.js 和 npm 可用：
node -v
npm -v
三、在 RHEL 上解压并运行项目
- 将项目打包文件复制到服务器：
scp my-svelte-demo.tar.gz tester@rhel-server:/home/tester/Projects/
- 解压并运行：
cd /home/tester/Projects
tar -xzvf my-svelte-demo.tar.gz
cd my-svelte-demo
npm run dev
默认端口是 5173，需开放防火墙端口（如果使用
firewalld）：
sudo firewall-cmd --add-port=5173/tcp --permanent
sudo firewall-cmd --reload
🛠️ 其他可选方案
- 使用
npm run build构建静态站点后再迁移 - 使用
npx serve dist或通过 nginx/Apache 提供服务 - 将 Node.js + 项目整体打包为离线安装包
✅ 总结表
| 步骤 | 操作 | 说明 |
|---|---|---|
| Debian 环境准备 | npm install + tar -czf | 确保依赖完整并打包 |
| RHEL 安装 Node.js | 使用离线版 .tar.xz | 配置路径环境变量 |
| 项目迁移运行 | 解压并 npm run dev | 本地启动开发服务器 |
