罗罗编程学习记录
本页内容 展开查看

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 流水线后端阶段怎么排?

一句话结论

提交后依次:静态检查/格式 → 单元测试 → 构建 → 集成测试 → 契约/质量扫描;失败阻断合并,产物可部署;数据库迁移与部署在后续发布阶段。

概念解释

  1. 拉取依赖、编译。
  2. 代码规范、静态扫描、漏洞检查。
  3. 单元测试 + 覆盖率门槛。
  4. 打包构建。
  5. 集成测试(测试容器)、契约测试。
  6. 产物归档,部署到环境再跑 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 测试的职责
  • [ ] 能确定事务边界并解释事务内禁忌动作