返回文档中心

常见安装问题

XYGo Admin 2025-02-20 60 次阅读

安装过程中常见问题的排查与解决

常见安装问题

Go 相关

Q: go install 下载超时

设置 Go 代理：

bash 复制代码 
go env -w GOPROXY=https://goproxy.cn,direct

Q: gf 命令找不到

确认 $GOPATH/bin 在 PATH 中：

bash 复制代码 
# 查看 GOPATH
go env GOPATH

# 添加到 PATH
export PATH=$PATH:$(go env GOPATH)/bin

Q: gf gen dao 连接数据库失败

检查 server/hack/config.yaml 中的数据库连接配置：

  • 确认数据库服务已启动
  • 确认用户名密码正确
  • 确认数据库已创建
  • PostgreSQL 注意端口是 5432，MySQL 是 3306

Node.js 相关

Q: pnpm install 失败

bash 复制代码 
# 清除缓存
pnpm store prune

# 设置国内镜像
pnpm config set registry https://registry.npmmirror.com

# 重试
pnpm install

Q: pnpm build 内存不足

bash 复制代码 
# 增加 Node.js 内存限制
export NODE_OPTIONS="--max-old-space-size=4096"
pnpm build

Q: 前端启动后页面空白

  1. 检查浏览器控制台是否有报错
  2. 确认后端服务已启动
  3. 检查 vite.config.ts 中的代理配置是否指向正确的后端地址
  4. 清除浏览器缓存和 localStorage

数据库相关

Q: 导入 SQL 报错

  • MySQL：确认使用 mysql_install.sql
  • PostgreSQL：确认使用 pgsql_install.sql
  • 不要混用两种数据库的 SQL 文件

Q: PostgreSQL 连接报 "password authentication failed"

检查 pg_hba.conf 文件，确认本地连接认证方式：

复制代码 
# IPv4 local connections:
host    all    all    127.0.0.1/32    md5

修改后重启 PostgreSQL。

Q: Redis 连接失败

bash 复制代码 
# 检查 Redis 是否运行
redis-cli ping
# 应返回 PONG

# 检查端口
netstat -tlnp | grep 6379

端口冲突

Q: 后端 8000 端口被占用

修改 config.yaml 中的端口：

yaml 复制代码 
server:
  address: ":8001"

同时修改前端 vite.config.ts 中的代理目标地址。

Q: 前端 5173 端口被占用

Vite 会自动尝试下一个可用端口，或手动指定：

typescript 复制代码 
// vite.config.ts
server: {
  port: 3000
}