ToB企服应用市场:ToB评测及商务社交产业平台

标题: Redis 在Go项目中的集成和同一管理 [打印本页]

---

作者: 悠扬随风    时间: 2024-12-15 11:09
标题: Redis 在Go项目中的集成和同一管理
本节我们在项目中安装和集成 go-redis，让项目能访问Redis，反面实战项目中的用户认证体系会依靠Redis来实现，像Token、Session这些都是在Redis中存储的。
  本节大纲如下：‍‍
  

  Redis的使用场景有不少，不外有一点必要提示的是别把Redis当数据库用哦。
     这里分享一篇 Redis应用场景汇总，内里罗列了十几个场景，大家有兴趣的可以看一下。
    go-redis 的安装和配置

  在我们的Go项目里访问Redis使用的是 go-redis 这个包，之前也见过一些项目使用redigo 来访问Redis，不外redigo已经停止维护了，以是就不思量使用它了。
  安装 go-redis 使用以下下令

1. go get github.com/redis/go-redis/v9

复制代码

安装过程中会向项目依靠中添加下面这些包，在gomod 文件中也会看到它们的身影。
  

  依靠下载完成后，我们先不发急去初始化它，还是先把干系的配置先在配置文件里写好。在 applicaiton.dev.yaml 增加Redis干系配置。

1. redis: # 记得更改成自己的连接配置
2.   addr: 127.0.0.1:31379
3.   password: 123456
4.   pool_size: 10
5.   db: 0

复制代码

其他两个情况的配置文件发起也先加上，避免配置文件之间布局和字段相差太多，等有测试和生产情况后再把配置调解过去即可。
  配置添加完后，我们在 config.go 中增加 Redis 这些配置字段的对应的范例定义

1. var (
2.  ...
3.  Redis    *redisConfig
4. )
6. // Redis 配置
7. type redisConfig struct {
8.  Addr     string `mapstructure:"addr"`
9.  Password string `mapstructure:"password"`
10.  PoolSize int    `mapstructure:"pool_size"`
11.  DB       int    `mapstructure:"db"`
12. }

复制代码

同时也在 bootstrap.go 中把config文件中的redis配置字段映射到 redisConfig 范例的变量 config.Redis上

1. func init() {
2.  env := os.Getenv("ENV")
3.  vp := viper.New()
4.     ...
5.     
6.  vp.UnmarshalKey("redis", &Redis)
7. }

复制代码

配置做好后，接下来我们在 dal/cache 目录中新建redisinit.go 文件，在其中对go-redis客户端进行初始化

1. var redisClient *redis.Client
3. func Redis() *redis.Client {
4.  return redisClient
5. }
7. func init() {
8.  redisClient = redis.NewClient(&redis.Options{
9.   Addr:         config.Redis.Addr,
10.   Password:     config.Redis.Password,
11.   DB:           config.Redis.DB,
12.   PoolSize:     config.Redis.PoolSize,
13.   DialTimeout:  10 * time.Second,
14.   ReadTimeout:  30 * time.Second,
15.   WriteTimeout: 30 * time.Second,
16.   PoolTimeout:  30 * time.Second,
17.  })
18.  
19.  if err :=redisClient.Ping(context.Background()).Err(); err != nil {
20.   // 连接不上redis 让项目停止启动
21.   panic(err)
22.  }}

复制代码

跟初始化GORM时一样，如果你不想用Go的init机制，这里可以把这个初始化方法修改名成InitRedis，到main函数中去调用它来手动完成初始化。
  Redis Key 的管理

  我们在使用Redis的时候，最好把Key 放在项目里同一的地方进行管理，同时在命名时给Key加上包含业务、项目、模块信息的前缀名，通过签证在盘标题的时候我们最最少能快速定位到缓存是哪个项目写进去的。
  我在平时维护项目中被 Redis 搞的头大的大部分情况是，很多旧代码在A项目里缓存了个什么数据，然后到下游的B项目再去读这个数据，根据缓存里数据的状态执行不同的逻辑分支。
  有的时候监控系统陈诉B项目出了Bug，盘标题看到从Redis里读取到的数据跟预想的不一样，一般人都会先在B项目中Debug，看下缓存设置的程序是不是有标题，但是针对这种情况把整个B项目搜遍也没发现缓存是从那里存进去的。 
  以是 Redis Key 的命名不能太随意，最好包含设置缓存的项目名、所属业务等能确定缓存泉源的信息。
  我们在项目的 common/enum 目录中新增rediskey.go 在其中对Redis 缓存的 Key 进行同一管理

1. / Redis Key的格式为:
2. //   项目名:模块名:键名
4. const (
5.  REDIS_KEY_DEMO_ORDER_DETAIL = "GOMALL:DEMO:ORDER_DETAIL_%s"
6. )

复制代码

这里先定义一个测试用的Redis缓存的键名。
  

• GOMALLEMO:ORDER_DETAIL_%s
  
  
  
  • Key的格式为 项目名:模块名:键名，你的公司大的话还可以在最前面加一个业务名，省得项目名重复了。
    
  • 项目名：GOMALL
    
  • 模块名：DEMO （因为是演示，正常情况下是ORDER、USER 这种模块名）
    
  • 键名：ORDER_DETAIL_%s
    
  
  

  在使用到这个 Redis 缓存的方法中可以来拿业务标识(比如订单号) 拼装出完备的Redis Key

1. redisKey := fmt.Sprintf(enum.REDIS_KEY_DEMO_ORDER_DETAIL, demoOrder.OrderNo)

复制代码

Redis怎么做日志链路追踪

  和在项目中集成ORM使用数据库时一样，除了关注常规的功能外，我们还要关注组件集成进项目后的可观测性。最底子的保障观测性的方式是组件日志整合到应用日志，并且通过traceId、reqeustId等方式讲它们归因到对应的请求上。
  关于这部分日志整合和链路追踪的内容，请扫码订阅专栏后阅读完备版。
  

  

  

  

  专栏配套的项目有完备的实当代码，订阅后加入项目访问 https://github.com/go-study-lab/go-mall/compare/c8...c9 能看本章节的详细代码。
  

  

专栏分为五大部分，主要内容架构如下（已更新32节）：

  

     
   

• 第一部分介绍让框架变得好用的诸多实战技巧，比如通过自定义日志门面让项目日志更简朴易用、支持自动记录请求的追踪信息和程序位置信息、通过自定义Error在实现Go error接口的同时支持给给错误添加错误链，方便追溯错误源头。
  
• 第二部分：讲解项目分层架构的设计和划分业务模块的方法和尺度，让你以后无论遇到什么项目都能按这套尺度本身划分出模块和逻辑分层。反面几个部分均是该部分所讲内容的实践。
  
• 第三部分：设计实现一个套支持多平台登录，Token泄露检测、同平台多设备登录互踢功能的用户认证体系，这套用户认证体系既可以在你未来开发产品时直接应用
  
• 第四部分：商城app C端接口功能的实现，强化分层架构实现的讲解，这里还会讲解用责任链、计谋和模版等设计模式去解决订单结算促销、支付方式支付场景等多种多样的实际标题。
  
• 第五部分：单元测试、项目Docker镜像、K8s摆设和服务保障干系的一些底子内容和注意事项
  

  

扫描上方二维码大概访问 https://xiaobot.net/p/golang 马上订阅

  

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。

---

欢迎光临 ToB企服应用市场:ToB评测及商务社交产业平台 (https://dis.qidao123.com/)

Powered by Discuz! X3.4