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 本地启动开发服务器
相关推荐
缘来小哥16 小时前
一文理解npm/yarn/pnpm中的版本通配符
npm·node.js
FreeBuf_1 天前
npm供应链攻击威胁开发环境安全
前端·安全·npm
longze_71 天前
开源npm引导guide组件
前端·javascript·npm·开源·开源软件·guide·引导组件
longze_71 天前
npm 打包上传命令,撤销错误版本
前端·npm·node.js
扯淡的闲人1 天前
关于NPM(Node Package Manager)的详细介绍
前端·npm·node.js
再学一点就睡2 天前
从 npm 到 pnpm:包管理器的进化与 pnpm 核心原理解析
前端·npm
卡拉叽里呱啦2 天前
拆分TypeScript项目的学习收获:处理编译缓存和包缓存,引用本地项目,使用相对路径
typescript·npm·yarn
一只喵喵豚2 天前
【Spark Core】(二)RDD编程入门
javascript·spark·npm
水冗水孚2 天前
面对业务需求,多思考一下如何更好实现,不要成为麻木的前端npm调包侠
react.js·npm
CF14年老兵3 天前
我为什么放弃了 React(或许你也该试试)🔥
react.js·svelte·trae