Go-Zero项目开发1: 即时通讯系统的业务分析与环境搭建

Go 语言数据库事务详解:从 db.Begin 到 Tx 的正确用法 本文详解Go语言中database/sql事务的正确用法,从*sql.Tx的底层模型出发,阐述事务与连接池的关系,提供标准事务模板,并强调使用db.BeginTx控制隔离级别与超时。重点剖析常见陷阱:误用db而非tx执行SQL、defer顺序错误、忽略Commit错误、事务过长导致资源耗尽等。结合可运行示例,涵盖事务内查询、预处理语句及保存点模拟嵌套事务,全面覆盖工程实践中的关键细节。 阅读详情

纲要

  • 项目业务功能拆解
    • 用户业务:注册、登录、信息查询
    • 社交业务:好友关系、群组管理、申请列表
    • 聊天业务:私聊/群聊、消息记录、已读未读状态
  • 系统架构设计
    • API 网关:统一入口、反向代理、服务路由
    • BFF 层:业务聚合,减少客户端多服务直接调用
    • 微服务层:按领域拆分(用户、IM、社交)
    • 消息队列:异步任务处理
    • 基础组件:etcd、MongoDB 等
  • 项目结构概览(树状目录)
  • 基础环境准备
    • 服务器规划(开发与测试用虚拟机)
    • 代码仓库(Git 私有仓库初始化与推送)
    • 容器镜像仓库(阿里云容器服务,命名空间与镜像仓库的创建)
    • 镜像推送与部署(docker tag, docker push, 私有镜像在 docker-compose 中的引用)

项目业务功能

本项目的核心目标是构建一个即时通讯(IM)系统,用户可通过界面登录,并与好友或群组进行实时聊天。围绕这一目标,业务可划分为三大模块:

  • 用户模块
    提供注册、登录、用户详情查询、用户搜索等功能。用户必须能够发现其他用户,才能建立好友关系或邀请加入群组。

  • 社交模块
    管理好友关系与群组关系,包括:好友申请、好友列表、群组创建、加入/退出群组、群组申请列表以及群成员列表等。

  • 聊天模块
    系统的核心功能,涵盖私聊与群聊。进一步拆分为:消息发送、消息接收、聊天记录存储、消息已读/未读状态同步等子功能。

系统架构设计

为支撑上述业务,系统采用基于 Go-Zero@latest 的微服务架构,关键分层如下:

HTTP/WebSocket

RPC

RPC

RPC

异步消息

RPC

RPC

客户端

API 网关

BFF 聚合层

用户微服务

IM 微服务

社交微服务

消息队列

关系数据库

API 网关

网关位于客户端与后端服务之间,承担反向代理与路由职责。所有客户端请求统一发往网关,由网关根据路由规则转发至对应的 BFF 服务。网关同时可集成认证、限流等功能,并屏蔽后端服务的多实例部署细节,使客户端无需关心内部服务地址。

BFF 层(Backend For Frontend)

在微服务体系中,不同客户端(Web、移动端)可能需要聚合多个微服务的数据。BFF 层即为特定前端定制的聚合服务,它将多个微服务的调用组合为一个粗粒度的 API,减少客户端请求次数。例如,“创建群组”操作需要调用社交服务创建群组、调用 IM 服务建立会话、调用用户服务获取成员信息,BFF 可在一个接口中完成这些聚合,避免客户端发起多次请求。

微服务层

按照业务领域垂直拆分:

  • 用户服务:处理用户注册、登录、信息管理等。
  • IM 服务:负责消息收发、会话管理、聊天记录持久化及已读未读状态。
  • 社交服务:管理好友关系、群组生命周期、申请列表等。

服务间通过 RPC 通信,基础组件依赖 etcd 实现服务注册发现,MongoDB 作为部分业务的数据存储。

消息队列

异步任务(如推送通知、离线消息处理)通过消息队列进行解耦,提高系统响应速度与扩展性。

项目结构概览

在 go-zero 项目中,目录结构通常按服务划分,并结合 BFF 层清晰组织:

im-system/
├── gateway/                 # API 网关 
│   └── etc/
│       └── gateway.yaml     # 网关配置 
├── bff/                     # BFF 聚合层 
│   ├── internal/
│   │   ├── handler/
│   │   ├── logic/
│   │   └── svc/
│   └── bff.go 
├── services/
│   ├── user/                # 用户微服务 
│   │   ├── internal/
│   │   └── user.go 
│   ├── im/                  # IM 微服务 
│   │   ├── internal/
│   │   └── im.go 
│   └── social/              # 社交微服务 
│       ├── internal/
│       └── social.go 
├── common/                  # 公共库、中间件等 
├── docker-compose.yml 
└── go.mod 

基础环境构建

服务器环境

开发阶段使用两台虚拟机(通过 VMware 创建):

  • 虚拟机 A:用于本地开发测试。
  • 虚拟机 B:用于集成后的部署验证与展示。

确保两台机器安装 Docker 及 Docker Compose,便于后续容器化管理。

代码仓库

选用 Git 私有仓库(以 Gitee 为例)管理项目源码。初始化步骤如下:

$ mkdir im-system && cd im-system 
$ git init 
$ echo "# IM System" >> README.md 
$ git add README.md 
$ git commit -m "first commit"
$ git remote add origin https://gitee.com/yourname/im-system.git  
$ git push -u origin master 

后续开发中所有代码改动均通过 commit 与 push 提交至远程私有仓库,确保代码安全与版本控制。

容器镜像仓库

使用阿里云容器镜像服务(ACR)存储自定义 Docker 镜像,便于在测试与生产环境拉取。

操作流程:

  1. 登录阿里云容器服务控制台,创建命名空间(例如 im-system)。
  2. 在命名空间下创建两个镜像仓库:user-rpc 与 api(或按实际服务命名),仓库类型选择“本地仓库”,以便镜像不公开。
  3. 配置访问凭证:固定密码设置为环境变量或保存于本地,后续推送/拉取均依赖此凭证。

镜像推送

在开发机上,已有通过 go-zero 构建好的本地镜像,需要打标签并推送至私有仓库。

# 为本地镜像打标签,使其对应仓库地址 
$ docker tag local-user-rpc:latest registry.cn-hangzhou.aliyuncs.com/im-system/user-rpc:latest 
$ docker tag local-api:latest registry.cn-hangzhou.aliyuncs.com/im-system/api:latest 
 
# 推送到私有仓库 
$ docker push registry.cn-hangzhou.aliyuncs.com/im-system/user-rpc:latest 
$ docker push registry.cn-hangzhou.aliyuncs.com/im-system/api:latest 

推送成功后,可在阿里云控制台对应仓库的“镜像版本”中确认已存在。

使用私有镜像部署

在 docker-compose.yml 中,将镜像地址替换为私有仓库地址。示例片段:

services:
  user-rpc:
    image: registry.cn-hangzhou.aliyuncs.com/im-system/user-rpc:latest 
    containers_name: user-rpc 
    restart: always 
    environment:
      - ETCD_ENDPOINTS=etcd:2379 
    networks:
      - im-net 
 
  api:
    image: registry.cn-hangzhou.aliyuncs.com/im-system/api:latest 
    ports:
      - "8888:8888"
    networks:
      - im-net 
 
  etcd:
    image: quay.io/coreos/etcd:v3.5.4 
    ...

若原有本地已存在旧镜像,可先清理后再启动:

# 删除所有本地镜像(谨慎操作)
$ docker rmi -f $(docker images -q)
 
# 重新启动服务,将自动拉取私有仓库镜像 
$ docker-compose up -d 

验证服务是否正常启动:

$ docker-compose ps 
$ curl http://localhost:8888/health 

至此,项目的基础运行环境搭建完成,后续即可在此基础上进行 go-zero 微服务的迭代开发。

总结

以上即对即时通讯系统业务需求、架构设计以及开发环境准备的完整梳理,为后续章节的功能实现奠定了坚实基础。在实际开发中,还需遵循 go-zero 框架的代码生成规范,确保服务间 RPC 通信的高效与稳定。

从零开始学习 Go 1.25 编程 今天是你新生活的第一天,无论年龄、背景如何,改变从这一刻开始。CodeGym帮助成千上万普通人转型为程序员,从零基础到掌握Go语言,完成真实项目,甚至入职心仪岗位。Go语言简洁高效,适合服务器端开发,是云基础设施、微服务和高负载系统的首选。2026年正是入行良机,你的经验反而是优势。别犹豫,迈出第一步,你将收获技能、自信与全新人生。🚀 阅读详情

相关推荐

Habitat-baselines v0.1.7防踩坑手把手带你跑通(全网唯一)

Habitat-baselines v0.1.7防踩坑手把手带你跑通(全网唯一)

shannanshouyin的博客 1282

使用go-zero快速搭建一个微服务(一)

gozero快速搭建

m0_59178355的博客 912

CTP高频Tick数据:五档期货Level2深度解析20241224

高频Tick五档期货Level2数据,作为一种先进的金融市场分析工具,以其一秒四次的高频更新,为投资者揭示了市场的微观结构。本文将深入探讨这一数据如何帮助投资者洞察市场动态,优化交易策略,实现投资收益的最大化。

level2Tick的博客 1218

Go-Zero 项目开发26: 实现用户在线离线状态维护

本文介绍了基于Redis和Go-Zero框架实现的即时通讯系统在线状态功能设计方案。主要内容包括业务需求分析(好友/群成员在线状态)、技术方案选型(使用Redis Hash存储状态)、核心流程设计(登录/退出状态维护、状态查询)以及代码实现要点。系统通过集中式状态存储和批量查询机制,实现了高效的状态管理,并针对不同场景采用推送与拉取相结合的变更通知策略。文中详细展示了项目结构、Redis配置、登录状态更新和查询接口的实现代码,为构建高可用在线状态服务提供了完整解决方案。

Wang的专栏 310

Intel网卡固件烧录实战:eeupdate与bootutil命令完全解析

固件作为硬件设备底层运行的软件,其稳定性直接决定硬件功能的完整性。网卡固件一旦损坏,常表现为MAC地址丢失、PXE启动失效、NVM数据异常导致降速或掉线。维护这类问题,需借助Intel官方工具eeupdate与bootutil在UEFI Shell或DOS环境下执行底层烧录操作。eeupdate负责网卡的身份信息与NVM存储管理,可重置MAC、恢复固件镜像;bootutil则专管启动行为,支持PXE配置与Boot Agent升级。从环境准备、命令参数到故障恢复,掌握这两款工具能让运维人员在修复存量网卡、应对

weixin_34269583的博客 314

深信服PT1-AF实验考试

深信服PT1-AF实验考试实验练习可以去深信服的在线实验平台(链接如下):深信服在线实验平台 (sangfor.com.cn)实验考试其实就是把所有的每一部分实验综合了起来以下内容仅做参考,不确保一样。

m0_72019240的博客 7128

每天10分钟学Go:第5课 switch分支判断

本课程讲解 Go 语言 switch 分支判断核心用法,涵盖单值匹配、多 case 合并、无表达式条件分支、fallthrough 穿透与类型 switch 断言,搭配可运行代码示例,带你掌握 Go 分支结构语法与实战写法。

2501_94567985的博客 261

在 SAP BTP ABAP 环境中测试多租户 SaaS 解决方案的完整实践指南

ABAP SaaS测试阶段关键实践 在SAP BTP ABAP环境中开发多租户SaaS解决方案时,测试阶段(TST)对确保产品质量尤为关键。测试阶段应包含两个主要维度: 业务功能验证: 通过软件组件管理确保测试环境与代码仓库同步 创建并验证业务角色分配,确保权限配置正确 测试Fiori Launchpad导航流程和跨应用跳转 验证inbound/outbound通信配置 自动化质量管控: 在开发环境(DEV)执行本地ATC检查和单元测试 通过ABAP Test Cockpit(ATC)进行代码质量检查 集成

2007 年 ~ 2025 年,深耕 SAP 技术 18 年 298

2026-11-11-Go分布式锁实战

线上偶发重复扣库存,查了半天是业务执行超过了锁的过期时间,锁提前释放,另一个请求拿到锁又执行了一遍。单机锁在多实例部署下失效,Redis SET NX PX 加锁、Lua 脚本原子释放、看门狗续期,这篇讲透分布式锁三大坑,附实现对照表和实战清单。

利威尔的博客,主要分享一些go后端,agent相关知识,都是最新最前沿而且是免费的,在我的专栏里有各种方向的详细分类和内容整理,详细内容请阅读主页置顶文章,希望对你有帮助。 297

一篇把 Transport 做到可复制的实战指南:从 CTS 底层表到 LSMW、Variant、Layout、TABU、Query、SAPscript 全对象搬运

本文深入解析SAP系统中的Transport机制,将其视为可审计、可追溯的变更流水线。文章从CTS/Transport Organizer通用方法论和具体对象搬运手法两个层面展开,详细介绍了LSMW项目、程序Variant、屏幕/ALV Layout、表数据、ABAP Query、SAPscript和SO10标准文本等对象的传输策略。通过真实案例说明,代码对象往往能被正确传输,但"运行体验"和"业务配置"却常被遗漏,导致QAS测试正常而PRD环境异常。文章提供了一套可

2007 年 ~ 2025 年,深耕 SAP 技术 18 年 179

Rockchip 自定义vendorstorages数据再u-boot通过cmdline给kernel传递数据

本文介绍通过vendorstorages,允许保存和读取自定义数据。通过在U-Boot中读取这些数据并将其添加到cmdline中,将这些数据传递给Linux内核,实现了一个灵活的方式来配置和定制系统的需求。

我其实什么都不会 1822

每天10分钟学Go:第9课 Range循环

在 Go 里,`range` 常用来遍历切片、数组、字符串、映射和通道。它会在每次循环时,把当前元素的信息交给循环变量。前面《》我们已经会写普通的for循环,可以把range理解成一种更方便的遍历方式。

2501_94567985的博客 196

C#与倍福Plc通信——使用仿真软件模拟倍福PLC运行

安装这个软件之前先安装VisualStudio,本文安装这个软件时已经安装了VisualStudio2019。1、下载倍福PLC编程软件TwinCAT。

qq_34059233的博客 3667

TinyGo 驱动 ESP32 端侧 AI 推理实战:纯 Go 实现轻量机器学习模型部署全流程

基于乐鑫官方 TinyGo 教程,从零实现纯 Go 语言开发 ESP32 端侧 AI 推理应用,覆盖环境搭建、模型转换到全流程部署。

嵌入式扫地僧 523

假人有限元模型

假人模型,车辆碰撞假人有限元模型,适合做乘员安全的研究者利用

WINCC7.3破解文件

WINCC7.3硬件够破解文件,有需要的下载!WINCC7.3硬件够破解文件,有需要的下载!

每天10分钟学Go:第1课 环境搭建与第一个Go程序

本号专注分享实战干货、避坑指南、性能调优、面试重难点, 每一篇都是亲手落地测试,帮你少走弯路、快速提升核心竞争力。5、将go程序构建成可执行的二进制文件:go build hello-world.go。3、编辑go文件写入程序:vim hello-world.go。4、运行go程序:go run hello-world.go。2、创建go文件:touch hello-world.go。1、创建项目目录:mkdir go-test261111。2、配置go环境变量。

2501_94567985的博客 124

大中型超市收银系统(可直接运行)

光步前台收银系统系统功能:商品销售、商品退货、挂单、收银员权限、会员销售、单品取消、整单取消、商品查询、脱机销售、脱机数据上传,基本资料下载,开钱箱、小票打印、收款结算,支持多币种付款方式(现金、储值卡、礼券、微信等),支持多种促销。运行环境:.net 4.0登陆信息用户名:1001 密码:123456内置商品信息,商品编码可输入00001000 - 00010000,测试效果相关功能键F5 结算 F9挂单 F11商品查询 F8退货 Insert单品取消 Del整单取消 F12开钱箱F2 会员 Ctrl+Z退出系统 Home 锁屏 相关源码待公开

Go 泛型入门:类型参数、约束与 Map/Filter/Stack

掌握类型参数、约束、~ 与 union,写出通用 Map/Filter/Stack,并知道什么时候不该用泛型。

JudithHuang的博客 217

复分析 阿尔福斯(Ahlfors) 第三版答案 英文

答案分为十章,有部分习题没有答案,全英文复分析阿尔福斯(Ahlfors) 第三版答案

Go 测试实战:表驱动、Benchmark 与 httptest

从表驱动、子测试到 Benchmark/Fuzz/httptest,建立“测行为不测实现”的测试习惯。

JudithHuang的博客 221

day01-认识Go语言 + golang环境的安装

Go语言由Google开发,2009年发布,兼具编译型性能与脚本语言易用性。其优势包括运行快、语法简洁、跨平台构建、丰富标准库及原生并发支持(goroutine与channel),适用于微服务、区块链等场景。安装时需配置GOROOT(安装路径)、GOPATH(工作空间,含pkg和bin目录)及GOBIN,并将%GOROOT%\bin、%GOBIN%、%GOPATH%加入系统Path。通过命令行验证环境后,可使用GoLand等IDE进行开发,快速上手高效编程。

2301_77190282的博客 243

Go1.25 升级后 GoLand 调试提示【变量不可用】解决方案

顶部菜单Help→在弹出的配置文件中添加下面一行,路径替换为你本机 dlv.exe 真实路径Windows 路径使用正斜杠,不要用反斜杠保存配置文件,完全重启 GoLand(不是只重启调试会话)Go 大版本升级后,优先检查 Delve 兼容性,这是 Go1.24+、Go1.25 最常见的调试踩坑点。升级dlv + 指定dlv路径 + 关闭编译优化参数,90% 的“变量不可用”问题都可以解决。

关于代码的那些事 253

深入浅出Go-pprof设计思想

本文以“不打扰的城市”为隐喻,生动诠释了Go语言pprof性能分析工具的核心理念:观测不应改变被观测对象。通过城市巡夜、速记员、账本等角色,类比pprof中SIGPROF、sigprof、profBuf等组件,揭示其低干扰采样机制——定时随机抽查、不携带额外开销、数据写入即丢、最终生成可视化火焰图。整套设计确保程序在被监控时仍保持原速运行,真正实现“看清系统而不影响系统”。

不愿言弃-念何的博客 590

Go 定时任务实战:工业边缘场景下的 robfig/cron

工业边缘网关里有大量周期性工作:设备状态轮询、数据同步、定时上报、日志清理。,本文从角度梳理其用法、任务封装、并发控制与常见的坑。

ZenovaEdgeOS的博客 474

Go FX 依赖注入框架:从入门到实战

FX 的核心思想就是“声明式依赖管理”—— 你只需要告诉它"我有这些组件,它们需要什么",剩下的创建、排序、生命周期都由框架自动处理。特性传统方式FX 方式依赖顺序手动维护自动解析生命周期手写 start/stopfx.Hook 自动调度测试难度高(需真实依赖)低(接口易 mock)代码可读性分散在各处集中在 module 中错误提示运行时 panic启动时清晰报错对于中大型 Go 项目,FX 能显著降低代码耦合度,提升可测试性和可维护性。

ggaofengg的专栏 178

纯 Go 写的 JS 引擎,跑分超过了 C 语言的 QuickJS

moejs 是一个纯 Go 编写的高性能 JavaScript 运行时,专为 Go 程序中的插件沙箱场景设计。发布于 2026 年 11 月,由 new-api 维护者 Calcium-Ion 开发,相较 C 版 QuickJS 快 35%,内存占用仅 81 KiB,单次调用仅 6.9 微秒。支持快速复用运行时、零拷贝解析、安全沙箱与 TypeScript 直接编译,通过 test262 80971 个用例零失败。适合高并发插件系统,如 AI 网关钩子处理,已在实际场景中实现请求吞吐量提升 8.6 倍。仓库

前端之虎陈随易 258

Go + SQLite:database/sql 增删改查与事务

用 database/sql + 纯 Go SQLite 跑通 CRUD,讲连接池、事务、NULL、迁移与备份。

JudithHuang的博客 175

Tailscale 上手:把几台机器拼成一个局域网

一台每天背来背去的笔记本,一台家里的 Windows 台式,一台常年开着的 Linux 小主机,外加一台云上的 VPS。于是每次想在笔记本上连一次小主机,流程都是:回忆 IP → 发现变了 → 去路由器后台查 → 发现不在同一个网 → 打开某个穿透工具 → 折腾十分钟 → 干正事只要两分钟。Tailscale 解决的就是这一串前置动作。装完之后,上面这些机器在我眼里变成了四个稳定的名字,不管它们实际待在世界哪个网络里。

weixin_42357472的博客 247

rofbuf.go —— 单写单读无锁环形缓冲

该文详解 Go 运行时 profBuf 的无锁环形缓冲设计,解决信号处理器(无 g、不可分配)与用户 goroutine 间安全通信难题。通过原子操作、2的幂环长、打包索引(64位分三段)、溢出记录合并及 ABA 防护机制,实现高并发下低延迟、零锁的数据传递。核心创新在于计数运算三件套与溢出协议,确保在极端环境下仍能可靠捕获 CPU profile 事件。

不愿言弃-念何的博客 595
上一篇: Go-Zero进阶实战2: 使用 Docker Compose 编排与部署微服务
下一篇: Go-Zero项目开发2: 用户服务构建与部署自动化
Wang's Blog
博客等级 码龄12年 7440粉丝 2427原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付:10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

Wang's Blog

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值