六边形架构在Go中核心是划清三道依赖线:领域层禁用适配器、端口接口须定义在domain或infra、DI入口必须位于adapter层;目录隔离重于结构模板,gRPC需作为驱动适配器而非领域延伸,Wire需严查指针返回与显式绑定。六边形架构在 Go 里不是"搭架子",而是划清三道线Go 项目用六边形架构,核心不是目录建得多整齐,而是靠三道不可逾越的依赖线把业务逻辑护住:领域层 不能 import 任何适配器(比如 github.com/go-sqlite/sqlite3、google.golang.org/grpc)、端口接口必须定义在领域层或 infra 层(不能藏在 adapter/repository 里)、Wire 或其他 DI 工具的 inject.go 文件必须落在适配器层------这是唯一能同时看到领域接口和具体实现的地方。常见错误现象:domain/order_service.go 直接 import "gorm.io/gorm",后续加 Redis 缓存或换 PostgreSQL 就得改业务代码正确做法:在 domain/repository.go 定义 type OrderRepository interface { Save(ctx context.Context, o *Order) error },让 adapter/repository/mysql_order_repo.go 去实现它Wire 的 InitializeApp() 函数必须放在 cmd/ 或 adapter/server/ 下,否则生成的依赖图会绕过端口约束目录结构别硬套模板,先守住 domain/ 和 adapter/ 的物理隔离很多团队卡在第一步,是因为照抄 "domain/aggregate/entity" 这类子目录,结果把 po.Order(数据库表结构)和 domain.Order(含业务规则的实体)混在同一个包里,或者让 adapter/controller 直接 new 出 domain.OrderService ------ 这等于把六边形画成了实心圆。domain/ 下只放:聚合根(order.Aggregate)、值对象(money.Money)、领域服务接口(order.PaymentService)、DTO(order.CreateOrderRequest)adapter/ 下分两块:controller/(接收 HTTP 请求、校验、转成 domain.DTO)、repository/(实现 domain.Repository 接口,用 SQL 或 gRPC 调用外部服务)infra/ 是可选缓冲区:放 infra/db/sqlx_client.go、infra/mq/kafka_producer.go 等"纯技术组件",它们被 repository 适配器调用,但 domain 层完全看不见gRPC 服务怎么当好"驱动适配器",而不是入侵领域层gRPC 不是领域模型的延伸,它是外部系统驱动你业务的一条通道。把它当"HTTP 的替代品"来用,就很容易把 proto 文件里的 message 直接当 domain 实体用,导致领域逻辑被 protobuf 序列化规则绑架。 Mokker AI AI产品图添加背景
相关推荐
小九九的爸爸3 小时前
前端想要入门Agent开发,要具备哪些Python基础?阿耶同学4 小时前
手把手教你用 LangGraph 搭建三层嵌套 Agent 架构jiayou645 小时前
KingbaseES 表级与列级加密完全指南花酒锄作田20 小时前
Pydantic校验配置文件hboot20 小时前
AI工程师第四课 - 深度学习入门GBASE1 天前
G术时刻 |GBase 8s数据库事务并发控制之封锁技术介绍(下)ZhengEnCi1 天前
P2M-Matplotlib折线图完全指南-从数据可视化到趋势分析的Python绘图利器ZhengEnCi1 天前
P2L-Matplotlib饼图完全指南-从数据可视化到图表定制的Python绘图利器曲幽1 天前
你的REST接口还在“过度投喂”数据吗?——FastAPI + GraphQL实战避坑指南用户8358086187911 天前
基于 Self-RAG 与列表级重排序的进阶 RAG 系统设计与实现