微服务 Controller 应该按业务分包,还是按调用方分层?真实项目里的取舍

发布时间:2026/11/5 1:57:35

微服务 Controller 应该按业务分包,还是按调用方分层?真实项目里的取舍 老炮淘金:13 个真实企业项目的架构高光 · S02基于一套零售基础档案微服务源码实读关键词:接口暴露面 · Controller 分包 · 鉴权边界 · 路径约定 · Feign 内部接口👋 欢迎阅读🏠个人主页:知守观📘我的专栏:老炮淘金:13个真实企业项目的架构高光💻当前内容:接口暴露面管理文章目录引言适合谁读包名就是信任级别同名类三份拷贝的账/internal/ 是跨团队的约定防线不在代码里约定已经开始侵蚀这套方案怎么用才不变形迁移检查清单老炮点评引言接手一个微服务,我习惯性先问一个问题:这些接口,分别给谁调的?给运营后台调的,要过登录态;给商店业务调的,也要过登录态,但权限模型不同;给 APP 调的,要过 token;给别的微服务调的,压根不该出内网;给所有人查的公共数据,免鉴权;还有自用调试的接口,只给自己人用。调用方不同,信任级别就不同。但在大多数工程的 controller 目录里,它们按字母顺序混在一起,看不出任何区别。最近读了一套零售基础档案服务的代码,它给了一个用目录结构回答的方案:controller 下面不按业务分包,按调用方的信任级别分包。这套方案值得拆开来评。这套方案最大的敌人不是设计,是半年后的新人。本篇你能拿走三样东西:按调用方信任级别切 Controller 的核心三层隔离做法:external / externalno / internal包名、注解、URL 前缀三者一致性的校验思路,以及同名类三份拷贝背后的取舍防止约定被侵蚀的三条规矩,含一个 CI 校验思路适合谁读适合有统一网关、服务间调用量大的平台团队;不适合单体应用,或网关规则缺失、暂时没人维护访问控制的团队。包名就是信任级别这个工程的 controller 目录长这样:controller/ ├── external/
延伸阅读

更多相关文章

2026/11/5 1:57:35

第311篇 插件化原理概览:Hook 与动态加载

承接上一篇《组件间通信:接口下沉与事件取舍》,那一篇讲的是「模块间如何在编译期保持独立」,这一篇讲一个更激进的思路:能不能让模块在运行时才加载,甚至不重新编译就更新功能? 这就是插件化与热修复的底层技术。 结论先行:所有 Android 动态化方案都建立在两个能力之…

2026/11/5 1:57:35

第314篇 Hilt 使用与原理:Android 专属的 DI 方案

承接上一篇《依赖注入入门:构造注入与字段注入》,那一篇讲清了「为什么要 DI」,这一篇讲「Hilt 具体怎么做」。Hilt 不是凭空出现的——它是 Dagger 针对 Android 生命周期做的重新设计,理解它必须先理解 Dagger 原本的问题。 结论先行:Hilt 相对 Dagger 的核心改进是「用…

2026/11/5 7:13:04

Git误操作急救指南:从撤销到数据恢复

1. Git误操作急救手册:从惊慌到从容的完整指南作为开发者,我们都经历过这样的时刻:手指在键盘上飞舞执行git命令后,突然意识到自己犯了个致命错误——误删了重要文件、提交了错误代码,或者更糟,把混乱的历史…

2026/11/5 7:13:04

西门子S7-200 SMART恒压供水系统开发实战

1. 项目背景与核心价值恒压供水系统是工业自动化领域的基础应用场景,我在某水处理厂改造项目中首次接触到西门子S7-200 SMART系列PLC与威纶通HMI的组合方案。这套系统通过PID算法将管网压力稳定在0.35MPa0.02的精度范围,相比传统继电控制节能达27%。本文…

2026/11/5 7:13:04

解决Cursor编辑器SSH连接密码框缺失问题

1. 问题现象与背景分析最近在使用Cursor编辑器通过SSH连接远程服务器时,遇到了一个颇为棘手的问题——密码输入框没有正常弹出,导致无法完成身份验证。作为一名长期使用各类开发工具的老手,我深知这类问题看似简单,但排查起来往往…

2026/11/5 7:13:04

Redis 6与Java客户端深度适配及性能优化实践

1. Redis 6与Java客户端的深度适配实践Redis作为当下最流行的内存数据库之一,其6.x版本在性能优化、多线程IO和安全特性等方面带来了显著提升。而Java作为企业级开发的主力语言,如何高效利用新版Redis的特性成为开发者关注的焦点。本文将基于Jedis、Lett…

2026/11/5 7:13:04

企业AI咨询转型:智能体技术应用与实施路径

1. 企业级AI咨询的现状与挑战企业咨询服务行业正面临前所未有的转型压力。传统咨询模式依赖人工经验输出,存在响应速度慢、知识更新滞后、服务成本高等痛点。根据麦肯锡最新调研数据,78%的企业客户对传统咨询服务的交付效率表示不满,而92%的C…

2026/11/5 7:08:04

智能ETL系统DeepSeek:Schema推理与自愈机制实践

1. 项目背景与核心价值在数据工程领域,ETL(Extract-Transform-Load)流程的质量直接决定数据分析的可靠性。传统ETL工具面临两大痛点:一是源数据结构变更导致管道频繁断裂,二是脏数据处理需要大量人工干预。DeepSeek项目…

2026/11/4 12:38:23

面向复杂光照与角度的宠物面部识别鲁棒性增强策略

在智慧养宠时代,基于视觉的宠物身份识别技术正逐步从实验室走向家庭应用。然而,与配合度高的人类不同,宠物是典型的“非合作生物识别对象”——它们不会主动配合摄像头调整姿态,更无法控制光照环境。实际应用中,我们常…

2026/11/4 21:04:25

SSM电子书店源码全解析:结构、原理、部署与排错实战

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/11/5 0:02:07

多智能体协作系统架构设计与实践优化

1. 多智能体协作系统的时代背景2017年Transformer架构的诞生彻底改变了人工智能的发展轨迹。当行业还沉浸在单一大模型带来的性能突破时,Anthropic的研究团队已经将目光投向了更前沿的领域——如何让多个智能体通过协作产生超越单体能力的系统智能。这就像交响乐团中…

2026/11/5 0:02:07

大模型系统性入门实战指南:从原理到部署微调的全链路路线

提到大模型的系统性入门,我先说个结论:这事真不难,难的是资料太散、路线太多,今天这个框架明天那个工具,新人很容易在“收藏夹吃灰”和“教程看到一半放弃”之间反复横跳。市面上关于大模型的内容少说有几十万篇&#…

2026/11/5 0:02:07

鸿蒙文件系统沙箱机制解析与开发实践

1. 鸿蒙文件系统沙箱机制深度解析作为一名从Android转向鸿蒙开发的工程师,我深刻体会到文件系统访问是迁移过程中最先遇到的"拦路虎"。在Android上运行良好的文件读写代码,在鸿蒙真机环境却频频出现文件写入后神秘消失或直接抛出权限拒绝错误的…

2026/11/4 12:38:23

面向复杂光照与角度的宠物面部识别鲁棒性增强策略

在智慧养宠时代,基于视觉的宠物身份识别技术正逐步从实验室走向家庭应用。然而,与配合度高的人类不同,宠物是典型的“非合作生物识别对象”——它们不会主动配合摄像头调整姿态,更无法控制光照环境。实际应用中,我们常…

2026/11/4 21:04:25

SSM电子书店源码全解析:结构、原理、部署与排错实战

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

还想了解更多?直接咨询顾问

免费诊断 + 免费方案 + 透明报价。

全国咨询热线400-8866-253
免费获取方案
☎咨询二维码 ☎ ↑