tikrok 第 7 代微服务重构： Golang 微服务 grpc 接口与服务实现隔离方案

目前，tkrok 第 7 代，实现代码行业达到了 20+ 万行，即将达到个人维护的边界。为方便后续个人远程开发者可以方便地接入项目维护工作，特此将第 6 代实现重构升级。分享给社区，为 golang 微服务兴旺，肋力。也方便后续开发者接手了解生产级的代码实现，为自学的开发者指南。

接口契约优先 实现细节隐藏 协作零泄露

核心目标拆解

 服务提供方：只暴露 IDL + 生成的 Client/Handler 接口，隐藏业务实现 服务消费方：仅依赖 RPC 客户端代码，无需拉取服务端源码 协作开发：通过契约版本协商变更，避免「改接口改到崩溃」 安全管控：私有仓库 + 权限隔离 + 依赖审计，防止源码泄露 

本质：「接口定义仓库」与「业务实现仓库」物理分离 + 自动化代码生成

整体架构设计（参考字节/腾讯实践）

 公司 Git 组织 ├── idl-registry/ # [公开] 接口定义仓库（只含 IDL + 生成代码） │ ├── user-service/ │ │ ├── user.thrift # 服务契约（唯一真理源） │ │ ├── kitex_gen/ # 自动生成的 Client/Handler/Model │ │ ├── go.mod # module company.com/idl/user-service │ │ └── README.md # 接口变更规范 + 版本日志 │ └── order-service/ │ └── ... │ ├── user-service-impl/ # [私有] 服务端实现仓库（仅内部可见） │ ├── handler/ # 业务逻辑实现（实现 idl 定义的 Handler 接口） │ ├── main.go # 服务启动入口 │ ├── go.mod │ │ require company.com/idl/user-service v1.2.0 # 依赖接口仓库 │ └── .gitignore # 禁止提交 handler 业务代码到 idl 仓库 │ ├── order-service-impl/ # [私有] 其他服务实现 │ └── ... │ └── internal-tools/ # [私有] 代码生成/发布工具链 ├── kitex-gen-wrapper.sh # 封装 kitex 生成命令 └── publish-idl.sh # 自动打标签 + 推送到私有 GOPROXY 

关键原则：

• idl-registry：只含接口契约 + 生成代码，权限开放给所有开发者
• *-impl：仅含业务实现，权限严格管控，禁止外部访问
• 消费方 go.mod 只依赖 company.com/idl/*，永远不依赖 *-impl