250708-Svelte项目从Debian迁移到无法联网的RHEL全流程指南

背景

在 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 上重新打包项目（含依赖）

1. 清理旧依赖并重新安装：

cd my-svelte-demo
rm -rf node_modules package-lock.json
npm install

2. 检查 Vite 执行文件是否正确：

ls -l node_modules/.bin/vite
head -n 5 node_modules/.bin/vite

输出示例（✅ 正确）：

#!/usr/bin/env node
require('../vite/bin/vite.js');

3. 打包整个项目（包含依赖）：

cd ..
tar -czvf my-svelte-demo.tar.gz my-svelte-demo/

---

二、在 RHEL 9.4 上准备运行环境

1. 安装 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

2. 验证 Node.js 和 npm 可用：

node -v
npm -v

---

三、在 RHEL 上解压并运行项目

1. 将项目打包文件复制到服务器：

scp my-svelte-demo.tar.gz tester@rhel-server:/home/tester/Projects/

2. 解压并运行：

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	本地启动开发服务器