Ubuntu 22.04下运行Age-viewer-go前端时出现Vite服务器URL未找到错误

安全阿岳

2026-7-22

解决Ubuntu 22.04下wails dev报错failed to find the Vite server URL

针对在Age-viewer-go项目的age-viewer目录执行wails dev时出现的failed to find the Vite server URL错误，可尝试以下排查和解决步骤：

补全前端依赖
进入age-viewer目录，执行对应包管理器命令安装所有依赖：
```
npm install
# 若项目使用yarn或pnpm，替换为：
yarn install
pnpm install
```
确保安装过程无报错，Vite相关依赖已正确安装。
手动启动Vite服务后再运行wails
1. 在age-viewer目录单独启动Vite开发服务器：
```
npm run dev
# 对应yarn dev / pnpm dev
```
  启动成功后控制台会显示Vite服务的URL（通常是http://localhost:5173）。
2. 新开终端，进入项目目录执行wails dev，此时wails会自动连接已启动的Vite服务。
检查wails配置文件
打开项目根目录的wails.json，确认frontend.devServer.url配置与Vite实际服务地址一致，示例配置：
```
"frontend": {
  "devServer": {
    "url": "http://localhost:5173"
  }
}
```
若Vite使用了自定义端口，同步修改此处的端口号。
清理缓存并重试
1. 清理Vite本地缓存：
```
rm -rf node_modules/.vite
```
2. 清理wails缓存：
```
wails clean
```
3. 重新安装依赖并启动服务：
```
npm install && wails dev
```
排查端口占用与Node.js版本
- 检查Vite默认端口（5173）是否被占用：
```
lsof -i :5173
```
  若被占用，可杀掉占用进程，或修改vite.config.js/vite.config.ts中的端口：
```
export default defineConfig({
  server: {
    port: 5174 // 替换为未被占用的端口
  }
})
```
- 确保Node.js版本为LTS版本（如18.x或20.x），可通过nvm切换版本：
```
nvm install 20
nvm use 20
```