06.1.1.4 工程落地:分层、异常、日志链路、配置与测试
所属:全栈开发面试题库 / 06 后端框架与工程实践 / 06.1 通用后端工程 / 06.1.1 API 设计与契约
本节要解决的问题
- 代码如何分层,职责边界落在哪一层?
- 异常、日志、链路追踪、配置如何统一规范?
- 测试策略、CI 与可观测性如何支撑接口持续演进?
06.1.1.4-001 后端分层架构:Controller/Service/Repository 职责是什么?
一句话结论
Controller 负责协议适配(参数解析、校验、响应装配),Service 承载业务规则与事务边界,Repository 封装数据访问;依赖方向向内,业务规则不泄漏到接口层。
概念解释
- Controller:接收请求、绑定参数、调用 Service、转换结果/错误;不含业务判断。
- Service:用例编排、业务规则、权限校验、事务边界;可调用多个 Repository/外部服务。
- Repository:数据存取细节,返回领域对象;不暴露查询条件拼装给上层。
示例
HTTP Request
→ Controller(解析/校验/响应)
→ Service(规则/事务/编排)
→ Repository(数据库/缓存/外部资源)
常见误区
- Controller 里写业务逻辑:难以复用、无法独立测试。
- Repository 直接返回 DTO/视图对象:数据结构与接口表示耦合。
追问
- 分层越多越好吗?小应用可简化为两层;核心是职责清晰而不是层数。
- DTO 与领域对象在哪转换?Controller/Service 边界,按团队约定固定一层。
06.1.1.4-002 跨层调用方向与依赖反转怎么理解?
一句话结论
上层定义所需接口,下层实现该接口,依赖指向抽象;业务核心不依赖框架与数据库细节,便于替换实现与单元测试。
概念解释
传统分层中 Service 依赖具体 Repository 类。依赖反转(DIP):Service 定义端口接口,Repository 实现它;Service 不知道持久化细节。更换 ORM/存储只改实现,核心规则不动。
示例
OrderService ──依赖──> IOrderRepository(端口)
^
OrderRepository(实现)┘
常见误区
- 接口只为「以后可能换数据库」而滥用:简单 CRUD 分层接口意义有限。
- 把框架基础设施对象(如 DbContext)传到 Service 各处:核心被框架绑定。
追问
- 依赖注入在分层中的作用?把实现组装推迟到启动阶段,层间只依赖抽象。
- 跨层共享的模型放哪?领域模型在核心层,DTO/契约模型在接口层。
06.1.1.4-003 全局异常处理器如何落地?
一句话结论
在框架入口注册统一异常处理器,按异常类型映射错误码与状态码,记录日志与 traceId,返回统一错误体;业务异常与系统异常分别处理,不吞异常。
概念解释
- 捕获业务异常:映射对应 4xx 与业务码,提示可返回用户。
- 捕获未处理异常:记 ERROR 日志(堆栈 + traceId),返回通用 5xx。
- 校验异常:聚合字段错误返回 422/400。
- 处理器是最后兜底,业务层仍应抛出明确异常类型。
示例
try (管道入口)
→ 业务异常 → 映射 code/status,WARN 日志
→ 校验异常 → 字段错误集合
→ 未捕获异常 → ERROR 日志 + 通用 500 + traceId
常见误区
- 空 catch 吞掉异常:问题被掩盖,日志无痕迹。
- 每个 Controller 各自 try-catch 拼响应:重复且易漏。
追问
- 异常处理器里还能访问什么?请求上下文(traceId、用户、参数摘要);不要在这里写业务补偿。
- 事务回滚与异常的关系?异常按框架规则触发回滚;被吞掉的异常可能导致事务提交。
06.1.1.4-004 日志结构应当包含哪些字段?
一句话结论
结构化日志至少包含时间、级别、traceId、当前用户/租户、模块、消息、关键业务标识、耗时与结果;敏感字段脱敏,字段名全链路统一。
概念解释
- 通用字段:timestamp、level、traceId、spanId、service、env。
- 业务字段:userId、tenantId、orderId、接口名、耗时 ms、结果状态。
- 结构化:键值对/JSON,便于日志系统检索聚合;避免无格式大段文本。
示例
{
"ts": "2026-11-18T03:20:00Z",
"level": "INFO",
"traceId": "7f3a91c2",
"userId": "10086",
"orderId": "1001",
"msg": "order created",
"costMs": 42,
"result": "success"
}
常见误区
- 日志只写一句「报错了」:无法定位业务对象。
- 把密码、令牌、身份证号明文打进日志。
追问
- 日志级别怎么分工?ERROR 需要告警;WARN 关注但不立即报警;INFO 记关键流程;DEBUG 仅排查时开启。
- 关键业务对象 ID 为什么必带?按订单/用户串起一次链路的多条日志。
06.1.1.4-005 traceId 如何生成与透传?
一句话结论
入口(网关或首个服务)生成 traceId,通过 HTTP 头/消息属性在服务间透传;日志、异常响应、下游调用都携带同一标识,形成一次请求的完整链路。
概念解释
- 生成:入口生成全局唯一 ID(如 UUID/雪花 ID)。
- 透传:HTTP 头(如
X-Trace-Id)、RPC 元数据、MQ 消息头。 - 关联:各服务日志记录同一 traceId;跨线程/异步任务需显式传递上下文。
示例
Gateway 生成 traceId
→ HTTP Header: X-Trace-Id: 7f3a91c2
→ 服务 A 日志、调 B 时继续带头
→ B/C 日志同 ID
常见误区
- 异步线程池/消息消费丢失上下文:新线程没有继承 traceId,链路断裂。
- 每个服务重新生成 ID:无法串联。
追问
- traceId 与 spanId 关系?traceId 标识整条链路,spanId 标识一次调用片段,父子 span 构成调用树。
- 响应里为什么回传 traceId?用户反馈时凭 ID 查服务端日志。
06.1.1.4-006 日志级别如何划分使用?
一句话结论
DEBUG 开发排查细节,INFO 记录关键业务节点,WARN 可容忍的异常但需关注,ERROR 影响功能需介入;生产默认 INFO,ERROR 触发告警。
概念解释
- DEBUG:变量、分支细节,生产一般关闭。
- INFO:请求入口/出口、状态迁移、关键定时任务完成。
- WARN:降级、重试、可恢复异常、接近阈值。
- ERROR:未处理异常、外部依赖失败、数据不一致,需要告警。
常见误区
- 所有问题都打 ERROR:告警疲劳,真正故障被淹没。
- 生产开大量 DEBUG:日志量与 IO 拖垮服务。
追问
- 循环里打日志怎么办?采样或汇总后打一条,避免刷屏。
- 异常日志打几次?在最外层记录一次完整堆栈,内层只记上下文避免重复。
06.1.1.4-007 日志量大时如何避免拖垮服务?
一句话结论
异步写入、采样、限流批量落盘,控制敏感与大对象输出;按级别与环境调整,监控日志量与磁盘,避免同步 IO 阻塞业务线程。
概念解释
- 异步:日志框架队列 + 后台批量写,业务线程不直接碰磁盘。
- 采样:高频只读日志按比例采样;错误日志不采样。
- 裁剪:不打印大对象全量、不重复打堆栈。
- 背压:队列满时按策略丢弃 DEBUG/WARN,优先保 ERROR。
常见误区
- 同步写文件且每条 flush:磁盘 IO 成为瓶颈。
- 把整段请求体/响应体打进 INFO 日志。
追问
- 异步日志丢失怎么办?关键审计日志写持久化存储;普通日志允许极端情况丢失少量。
- 日志量突增说明什么?可能是异常循环、重试风暴或攻击,需告警关联。
06.1.1.4-008 配置外置与环境区分怎么做?
一句话结论
配置不写死在代码里,按环境(开发/测试/生产)分离来源;代码只引用配置键,敏感配置与普通配置分开管理,构建产物不绑定环境。
概念解释
- 来源:配置文件、环境变量、配置中心、命令行参数;优先级按平台约定。
- 环境区分:数据库连接、地址、开关、限流配额按环境注入。
- 同一构建产物可部署到不同环境,启动时读配置。
常见误区
- 把生产地址/账号写进代码库:泄露且改环境要重新编译。
- 多环境配置文件互相覆盖后残留测试值。
追问
- 配置与代码版本如何对应?不可变发布 + 配置版本记录;变更可追溯回滚。
- 本地开发配置放哪?
.env/本地配置文件并加入忽略清单,不提交真实值。
06.1.1.4-009 配置热更新如何实现?
一句话结论
配置中心监听变更推送,应用订阅刷新回调;可热更的(开关、配额、文案)重新绑定到配置对象,不可热更的(连接串、证书)提示重启;变更带审计。
概念解释
- 静态配置:启动时读取一次,变更需重启。
- 动态配置:Options 快照 + 变更通知,业务每次读取最新值。
- 校验:热更新配置先校验合法性,非法值拒绝并保留旧值。
示例
配置中心变更
→ 推送/订阅回调
→ 重新绑定 Options → 校验通过生效;失败告警保留旧值
常见误区
- 把需要重建连接的配置(数据库连接池参数)无重启直接套用:旧连接行为不一致。
- 热更新配置无审计:谁改的、何时改的无法追溯。
追问
- 配置刷新后缓存的对象怎么办?可重载对象每次读快照;持有旧实例的需要重建。
- 动态配置要不要灰度?核心开关可按实例/租户逐步放量。
06.1.1.4-010 参数校验放在哪一层?
一句话结论
入口层做格式与基础校验(类型、必填、范围),服务层做业务规则校验(状态、归属、额度);两层都不能省,服务层是最终防线。
概念解释
- 接口层:Bean Validation/注解校验结构、类型、长度、正则。
- 服务层:跨字段、状态机、权限归属、外部约束;不依赖调用方一定会过前端/网关校验。
- 校验失败返回明确字段错误,而不是抛系统异常。
常见误区
- 只靠前端传参合法:接口可被直接调用绕过页面。
- 服务层重复堆砌格式校验:基础类型校验交给入口,服务层聚焦规则。
追问
- 枚举/白名单校验在哪?入口校验取值范围;业务允许的状态迁移在服务层。
- 复杂对象嵌套校验怎么组织?校验器按对象分组,错误信息聚合到字段路径。
06.1.1.4-011 测试金字塔在后端如何落地?
一句话结论
底部大量快速单元测试,中部适量集成测试,顶部少量端到端测试;按速度与成本分层,核心业务逻辑由单元测试覆盖,外部依赖由集成测试验证。
概念解释
- 单元测试:纯函数、规则、校验,mock 外部依赖,运行快。
- 集成测试:数据库、缓存、消息、外部客户端配合测试容器/测试实例。
- E2E:关键业务链路走真实接口,数量少、运行慢。
示例
/\ E2E(少量,关键链路)
/ \ 集成测试(适量,依赖协作)
/____\ 单元测试(大量,业务逻辑)
常见误区
- 只写 E2E:反馈慢、不稳定、定位困难。
- 单元测试全部 mock 掉被测对象本身:断言失去意义。
追问
- 测试覆盖率目标多少?关键路径高覆盖,但覆盖率数字不等于测试质量。
- 集成测试依赖共享数据库吗?建议独立测试库/Testcontainers,避免相互污染。
06.1.1.4-012 单元测试与集成测试的边界是什么?
一句话结论
单元测试隔离被测单元,外部协作者用替身,验证业务规则;集成测试验证真实组件间的协作(SQL、序列化、消息收发),不追求规则分支全覆盖。
对比
| 维度 | 单元测试 | 集成测试 |
|---|---|---|
| 依赖 | mock/stub | 真实组件或测试容器 |
| 速度 | 快 | 较慢 |
| 验证重点 | 规则、分支、边界 | 协作契约、持久化、序列化 |
| 数量 | 多 | 适量 |
常见误区
- 连数据库的测试也叫单元测试:运行慢且受数据影响。
- 集成测试里断言大量内部实现细节:脆弱难维护。
追问
- Repository 层测试算哪类?连真实库(或测试容器)属于集成测试。
- mock 过度的表现?每个调用都 mock,测试只验证交互次数而非结果。
06.1.1.4-013 契约测试与端到端测试如何分工?
一句话结论
契约测试验证服务间接口约定(字段、行为、兼容),E2E 验证完整业务流程走通;前者保护独立发布,后者保障用户链路,两者不互相替代。
概念解释
- 契约测试:提供方/消费方围绕契约互验,发现破坏性变更。
- E2E:从入口到数据库/UI 跑通关键场景,覆盖少量主干。
- 接口 mock、契约测试、集成测试、E2E 各有定位,缺一不可但数量递减。
常见误区
- 用 E2E 覆盖所有接口组合:成本高、易 flaky。
- 只测自己服务内部:跨团队接口破坏发现太晚。
追问
- 消费方驱动契约怎么工作?消费方定义期望交互,提供方验证可满足。
- 契约测试失败先修哪边?先判断是提供方破坏兼容还是消费方滥用,按契约裁决。
06.1.1.4-014 异步任务与定时任务如何测试?
一句话结论
把任务逻辑与调度触发分离:纯逻辑用单元测试覆盖;时间相关用可控时钟替身;消息消费/异步执行用测试容器或同步执行模式验证。
概念解释
- 时钟注入:任务依赖时间接口,测试传入固定时间。
- 任务体独立:
execute()可被测试直接调用,调度层只负责触发。 - 重试/死信:测试模拟失败与重投,验证幂等与补偿。
常见误区
- 测试里
Thread.sleep等异步完成:慢且不稳定。 - 定时任务时间逻辑写死在调度注解里:无法测试边界时间。
追问
- 消息消费幂等怎么测?重复投递同一消息两次,断言只产生一次副作用。
- 并发任务怎么测?并发提交同一任务,验证去重与状态一致。
06.1.1.4-015 CI 流水线后端阶段怎么排?
一句话结论
提交后依次:静态检查/格式 → 单元测试 → 构建 → 集成测试 → 契约/质量扫描;失败阻断合并,产物可部署;数据库迁移与部署在后续发布阶段。
概念解释
- 拉取依赖、编译。
- 代码规范、静态扫描、漏洞检查。
- 单元测试 + 覆盖率门槛。
- 打包构建。
- 集成测试(测试容器)、契约测试。
- 产物归档,部署到环境再跑 E2E/回归。
常见误区
- CI 只跑编译:问题到测试/生产环境才暴露。
- 集成测试放在本地手动跑:主干长期不回归。
追问
- 迁移脚本在 CI 跑吗?生成/校验迁移可在 CI;执行迁移随发布流程在受控环境做。
- 流水线时长怎么控制?慢测试并行或拆分,保持快速反馈。
06.1.1.4-016 代码规范与评审关注点有哪些?
一句话结论
统一命名、分层、错误处理、日志与配置规范;评审重点看职责边界、边界条件、安全校验、事务与并发,而不是风格细节争论。
概念解释
- 规范:命名、目录、错误码、日志字段、配置键统一。
- 评审清单:业务规则是否在正确层、是否有归属/权限校验、事务边界、异常处理、空值与边界、敏感信息、测试覆盖。
常见误区
- 评审只看格式风格:可用 lint/格式化工具自动解决。
- 忽略越权与异常分支:线上事故高发区。
追问
- 规范落地靠什么?静态检查 + 模板 + 评审清单,而不是口头约定。
- 老代码不符合规范怎么办?随改动逐步收敛,不搞大规模无关重写。
06.1.1.4-017 可观测性三件套:日志、指标、追踪如何配合?
一句话结论
日志提供事件细节,指标提供聚合趋势与告警,追踪展示调用链耗时与瓶颈;三者用同一 traceId/服务/实例关联,分别回答「发生什么」「是否异常」「慢在哪」。
概念解释
- 指标:QPS、延迟分位、错误率、队列深度、连接池占用,阈值告警。
- 日志:具体事件、对象 ID、错误堆栈。
- 追踪:跨服务调用树,每段耗时与状态。
- 关联:指标定位异常时段 → 追踪找到慢/错链路 → 日志查细节。
常见误区
- 只有日志:没有聚合趋势,异常靠人翻。
- 只看指标不看链路:无法定位具体下游。
追问
- 后端应埋哪些基础指标?请求量/延迟/错误率、依赖调用、线程池/连接池、队列积压。
- 追踪采样怎么定?错误请求全采,正常请求按比例采样。
06.1.1.4-018 健康检查端点应当检查什么?
一句话结论
存活探针只验证进程可响应;就绪探针检查可服务依赖(数据库、缓存、消息等),失败时摘流;不要把健康检查做成昂贵的全量业务探测。
概念解释
- Liveness(存活):进程活着即可,失败由平台重启。
- Readiness(就绪):依赖是否可达,失败从负载均衡摘除,不重启。
- 检查内容:关键依赖连通性;避免在健康端点跑重查询或外部慢速调用。
示例
/live → 进程响应 200
/ready → 检查 DB/Redis/MQ 连通,任一不可达返回 503
常见误区
- 存活探针里检查数据库:数据库抖动导致平台反复重启健康实例。
- 健康检查返回完整业务数据:被滥用做轮询接口。
追问
- 依赖检查失败如何分级?核心依赖不可用摘流;非核心依赖可标记降级但保持就绪。
- 健康检查需要鉴权吗?集群内探针可内网放开,注意网络隔离。
06.1.1.4-019 如何管理接口的请求示例与测试用例?
一句话结论
示例与用例从契约/测试生成或集中维护在契约文件中;正常、参数错误、权限不足、下游失败四类场景都要有示例,随版本更新。
概念解释
- 文档示例:OpenAPI
example,覆盖典型成功与常见错误。 - 测试用例:边界值、非法输入、并发/重复提交、依赖失败注入。
- 维护:示例与代码/契约同仓评审,避免文档示例过期。
常见误区
- 示例只放成功请求:接入方不知道错误长什么样。
- 测试用例藏在个人本地脚本里:不可回归。
追问
- 接口变更时示例怎么同步?契约 diff 触发示例评审;生成器自动更新可更新部分。
- 敏感示例数据怎么处理?用脱敏/模拟数据,不放真实账号令牌。
06.1.1.4-020 分层下事务边界应该落在哪一层?
一句话结论
事务边界放在 Service 用例层:一个业务用例对应一个事务,包住数据库读写;Repository 只做单操作,Controller 不控制事务,事务内不掺 RPC/消息发送。
概念解释
- Service 编排多个 Repository 操作,需要一致提交时开启事务。
- Repository 方法自身不跨库开事务;单条操作由默认事务保证。
- 事务范围:仅数据库操作;远程调用、发消息、写外部系统放到事务提交后(见 06.1.2.4 数据访问边界)。
常见误区
- 在 Repository 每个方法开事务:跨表操作无法一致回滚。
- 事务内调用外部接口:持锁等待远程响应,拉长事务与锁时间。
追问
- 为什么事务内不发消息?消息可能在提交前发出,回滚后消费者读到脏数据;用 Outbox/事务提交后事件。
- 跨服务一致性怎么办?本地事务 + 最终一致(补偿/Outbox),不用分布式长事务硬扛。
本节自检
- [ ] 能说清三层职责与依赖方向,把业务规则落在正确层
- [ ] 能设计统一异常处理器与结构化日志字段
- [ ] 能说明 traceId 生成透传链路与异步上下文传递
- [ ] 能划分单元/集成/契约/E2E 测试的职责
- [ ] 能确定事务边界并解释事务内禁忌动作