Valkyrie项目常见问题解决方案

Valkyrie项目常见问题解决方案

Valkyrie A Fullstack Discord Clone using React and Go. 项目地址: https://gitcode.com/gh_mirrors/val/Valkyrie

项目基础介绍和主要编程语言

Valkyrie是一个全栈的Discord克隆项目，使用了React和Go语言进行开发。该项目旨在提供一个类似于Discord的实时通信平台，具备消息、频道、服务器CRUD、认证、文件上传、直接消息、好友系统、通知系统、基本 moderation 和基本语音聊天等功能。

主要编程语言：

• 前端：React（使用Chakra UI作为UI库，React Query和Zustand进行状态管理，TypeScript）
• 后端：Go（使用Gin作为HTTP服务器，Gorilla Websockets进行WebSocket通信，Gorm作为数据库ORM，PostgreSQL存储数据，Redis存储会话和重置令牌，S3存储文件，Gmail发送邮件）

新手使用项目时需要特别注意的3个问题及详细解决步骤

1. 环境配置问题

问题描述：新手在配置开发环境时，可能会遇到依赖安装不全或版本不匹配的问题。

解决步骤：

1. 安装Docker：确保已安装Docker，并启动PostgreSQL和Redis容器。可以使用以下命令：

   make postgres
   make redis
   make start
   make createdb
   

2. 安装Go：确保已安装最新版本的Go，并安装所有依赖：

   go mod tidy
   

3. 配置环境变量：将.env.example重命名为.env，并填写必要的配置项，如数据库连接、Redis连接、CORS源等。

2. 前端依赖安装问题

问题描述：在安装前端依赖时，可能会遇到Node版本不兼容或依赖包安装失败的问题。

解决步骤：

1. 安装Node：确保已安装Node 20或LTS版本的Node。
2. 安装Yarn：使用Yarn作为包管理工具，安装所有依赖：

   yarn install
   

3. 运行前端：使用以下命令启动前端开发服务器：

   yarn start
   

3. 后端运行问题

问题描述：在运行后端服务器时，可能会遇到端口冲突或环境变量配置错误的问题。

解决步骤：

1. 检查端口配置：确保.env文件中的PORT配置正确，且没有其他服务占用该端口。
2. 运行后端：使用以下命令启动后端服务器：

   go run github.com/sentrionic/valkyrie
   

3. 使用预编译版本：如果不想安装Go和所有依赖，可以从Release标签下载预编译的服务器，但仍需完成环境配置步骤1、2和4。

通过以上步骤，新手可以顺利配置和运行Valkyrie项目，并解决常见的环境配置和依赖安装问题。

Valkyrie A Fullstack Discord Clone using React and Go. 项目地址: https://gitcode.com/gh_mirrors/val/Valkyrie