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

📌 背景

在 Debian 上使用以下命令创建了一个 Svelte 项目:

bash 复制代码
npm install -g sv
npx sv create my-svelte-demo
cd my-svelte-demo
npm install
npm run dev

现在需要将该项目迁移到一台 无法联网的 RHEL 9.4 服务器 上运行,出现如下报错:

bash 复制代码
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. 清理旧依赖并重新安装:
bash 复制代码
cd my-svelte-demo
rm -rf node_modules package-lock.json
npm install
  1. 检查 Vite 执行文件是否正确:
bash 复制代码
ls -l node_modules/.bin/vite
head -n 5 node_modules/.bin/vite

输出示例(✅ 正确):

bash 复制代码
#!/usr/bin/env node
require('../vite/bin/vite.js');
  1. 打包整个项目(包含依赖):
bash 复制代码
cd ..
tar -czvf my-svelte-demo.tar.gz my-svelte-demo/

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

  1. 安装 Node.js(离线)

bash 复制代码
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
  1. 验证 Node.js 和 npm 可用:
bash 复制代码
node -v
npm -v

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

  1. 将项目打包文件复制到服务器:
bash 复制代码
scp my-svelte-demo.tar.gz tester@rhel-server:/home/tester/Projects/
  1. 解压并运行:
bash 复制代码
cd /home/tester/Projects
tar -xzvf my-svelte-demo.tar.gz
cd my-svelte-demo
npm run dev

默认端口是 5173,需开放防火墙端口(如果使用 firewalld):

bash 复制代码
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 本地启动开发服务器
相关推荐
jason_yang15 小时前
Workspace搭建Vue3+组件分离的Monorepo项目
git·npm·前端工程化
三十_1 天前
私有 npm 仓库实践:Verdaccio 保姆级搭建教程与最佳实践
前端·npm
web打印社区1 天前
最简单的 Web 打印方案:用 5 分钟上手 web-print-pdf(npm 包)
前端·pdf·npm
寒山李白1 天前
npm镜像源配置指南
前端·npm·node.js
沙白猿2 天前
npm启动项目报错“无法加载文件……”
前端·npm·node.js
Bruce-li__2 天前
前端开发利器:nvm、npm与pnpm全面解析与TypeScript/JavaScript选择指南
javascript·typescript·npm
Dontla2 天前
npx命令介绍(Node Package Execute)(允许开发者直接执行来自npm注册表的包中的二进制文件,而无需全局安装)临时使用
前端·npm·node.js
张人玉2 天前
npm和pnpm命令大全
前端·npm·node.js
杨晓风-linda2 天前
npm玩转技巧
前端·npm·node.js
weixin_456904272 天前
npm install 时包库找不到报错解决
前端·npm·node.js