用途:该技能面向 BK-CI 微服务底层基础设施,关注“微服务底座能力”而非单模块业务规则。当问题涉及服务如何互相通信、配置如何分环境、事件如何解耦时,通常归入此技能。
主要能力与主题:条件配置(多环境、多 profile、特性开关);事件驱动(事件驱动或 MQ 异步处理);服务间通信(Feign 调用、降级和超时控制);国际化与日志(统一 i18n 文案与日志规范)。
使用方式:先按主题进入对应参考文档:条件配置 reference/1-conditional-config.md;事件驱动 reference/2-event-driven.md;服务间通信 reference/3-service-communication.md;国际化与日志 reference/4-i18n-logging.md。若需要框架级横切实践,切到 common-technical-practices;若需要具体工具类,切到 utility-components。
适用场景:配置多环境、多 profile、特性开关;实现事件驱动或 MQ 异步处理;做服务间通信、Feign 调用、降级和超时控制;处理国际化文案和日志规范。
不适用场景:只是 AOP、分布式锁、重试、参数校验这类横切实践;只是使用 JWT、表达式解析、线程池等工具组件;只是某个模块自己的业务逻辑。
高信号规则与限制:多环境配置、事件、Feign、日志/i18n 都属于平台级基础设施,核心是稳定性、可维护性和跨模块一致性;服务间调用要同时考虑超时、降级、循环依赖和可观测性;事件驱动要优先考虑幂等和异步一致性。关键陷阱包括:把微服务基础设施和横切实践混在一起;只写调用逻辑,不处理超时、降级和链路追踪;只接入 MQ,不处理幂等、重放和事件顺序;日志和 i18n 没有统一规范,导致跨模块行为割裂。