buguge - Keep it simple,stupid

✅ 知识就是力量,但更重要的,是运用知识的能力✅ why buguge?

导航

还在对“单接口实现”乐此不疲?你也许是在耍流氓~

代码评审时,我又一次看到了这种熟悉的味道:

public interface UserService {
    UserDTO getById(Long id);
    void save(UserSaveCmd cmd);
    void changeStatus(Long id, Integer status);
}

@Service
public class UserServiceImpl implements UserService {
    @Override
    public UserDTO getById(Long id) { ... }

    @Override
    public void save(UserSaveCmd cmd) { ... }

    @Override
    public void changeStatus(Long id, Integer status) { ... }
}

我翻了一下这个项目,这种"一个接口配一个实现类"的组合,一共有 87 处。

我挨个点进去看 UserService、OrderService、ContractService、MerchantService……没有一个接口有第二个实现。

这就是今天想聊的事:单接口实现(一个 interface 只有一个 impl),在绝大多数业务系统里,不是设计优雅,是自我感动。

一、先把话说清楚:interface 到底是用来干嘛的

Java 里引入 interface,核心价值就三条:

  1. 多态——同一个契约,多个实现,运行时切换
  2. 解耦边界——跨模块/跨团队协定时,接口是契约
  3. 框架需要——JDK 动态代理、SPI、Spring AOP 等场景要求接口存在

注意第一条是最核心的。一个接口从头到尾只有一个实现,多态这条直接从根上就没了;第二条在垂直分工的业务系统里也基本用不上(Controller 到 DAO 都是同一个人写);第三条只有真正被框架代理时才成立,而 Spring 现在默认 CGLIB 代理具体类,也不需要接口。

三条价值全部落空,你还留着它,图什么?

二、单接口实现的真实代价

代价一:文件数翻倍,改一处要动两处

加一个方法:

// 1. 先在接口加签名
public interface UserService {
    UserDTO getById(Long id);
    void freeze(Long id);   // ← 新增
}

// 2. 再去实现类加实现
@Service
public class UserServiceImpl implements UserService {
    @Override
    public void freeze(Long id) { ... }
}

删一个方法、改个参数名、加个 @Valid 注解——每一次都要在两个文件之间来回横跳。87 个接口 × 平均 5 个方法,光是"同步修改"这个动作,团队一年要做几千次。

代价二:代码追溯多一跳

Controller 里看到这段:

@RestController
public class UserController {
    @Resource
    private UserService userService;

    @PostMapping("/freeze")
    public void freeze(@RequestParam Long id) {
        userService.freeze(id);
    }
}

你想看 freeze 的实现,得先跳到 UserService 接口,再点 "Go to Implementation" 跳到 UserServiceImpl。IDEA 救得了你一次两次,救不了你一天几十次。

调试时更难受——断点打在接口方法上, IDEA 会告诉你"这个方法没有实现代码",你得手动找到那个 Impl 再打一次。

代价三:"未来可能有多实现"是个伪命题

我听过最多的辩护是:

"现在虽然只有一个实现,但未来可能有多个,先留个接口方便扩展。"

兄弟,未来是哪个未来?

  • 用户服务的第二个实现是什么?UserServiceImpl2?
  • 订单服务的第二个实现是什么?OrderServiceImplForTest?

业务 Service 的多实现概率,其实极低。真正会多实现的场景就那么几类:

  • 支付通道(支付宝/微信/银联)
  • 短信/邮件/推送(阿里云/腾讯云/极光)
  • 存储策略(本地/OSS/S3)
  • 风控规则(规则A/规则B/规则C)

这些一开始就知道会有多个,接口该建。而 UserService、OrderService、ContractService 这种领域实体服务,十有八九一辈子就一个实现。

为了那"十之一二"的可能性,给"十之八九"全部上了接口——这不是前瞻,这是焦虑。

代价四:测试收益是幻觉

"有接口才好 mock" —— 这话在 2015 年成立,现在不成立。

// 没有接口,Mockito 照样 mock 具体类
@SpringBootTest
class OrderServiceTest {
    @MockBean
    private UserService userService;   // 直接 mock 具体类,不需要接口

    @Autowired
    private OrderService orderService;

    @Test
    void testCreateOrder() {
        given(userService.getById(1L)).willReturn(new UserDTO());
        orderService.create(...);
    }
}

Mockito 从 2.x 开始就能 mock 具体类、final 类(开启 inline mock maker 后 final 也行)。"为了测试才建接口"这个理由,早就过期了。

三、重构前后对比

重构前(单接口实现,样板代码)

// UserService.java
public interface UserService {
    UserDTO getById(Long id);
    void save(UserSaveCmd cmd);
    void changeStatus(Long id, Integer status);
    void freeze(Long id);
    void unfreeze(Long id);
}

// UserServiceImpl.java
@Service
public class UserServiceImpl implements UserService {
    @Resource private UserMapper userMapper;

    @Override public UserDTO getById(Long id) { ... }
    @Override public void save(UserSaveCmd cmd) { ... }
    @Override public void changeStatus(Long id, Integer s) { ... }
    @Override public void freeze(Long id) { ... }
    @Override public void unfreeze(Long id) { ... }
}

// Controller
@Resource private UserService userService;

文件数:2。方法签名重复:5 处。跳转次数:2 次。

重构后(直接具体类)

// UserService.java(只有一个文件)
@Service
public class UserService {
    @Resource private UserMapper userMapper;

    public UserDTO getById(Long id) { ... }
    public void save(UserSaveCmd cmd) { ... }
    public void changeStatus(Long id, Integer s) { ... }
    public void freeze(Long id) { ... }
    public void unfreeze(Long id) { ... }
}

// Controller
@Resource private UserService userService;   // 注入具体类,Spring 完全支持

文件数:1。方法签名重复:0。跳转次数:1 次。

四、Spring 代理实测:没有接口,一切正常

很多人担心:"去掉接口,Spring 的 @Transactional、@Cacheable、AOP 还能生效吗?"

答案是:能,而且 Spring Boot 2.x 之后默认就这么干的。

一个最简单的 Spring Boot 项目,没有任何接口,只有具体类。定义一个 UserService 具体类,加上 @Transactional 和 @Cacheable 注解,然后在任意地方打印 userService.getClass(),输出如下:

class com.example.demo.service.UserService$$EnhancerBySpringCGLIB$$xxxx

看到 CGLIB 字样了吗?Spring 自动用 CGLIB 创建了具体类的子类代理,事务、缓存、AOP 全部挂在这个代理上。整个过程不需要任何接口。

对比一下:如果非要用接口,代理类型会变成:

class com.sun.proxy.$ProxyXX   // JDK 动态代理

两种代理都能正常工作,区别只是:

  • JDK 动态代理:必须基于接口,只能代理接口中的方法
  • CGLIB 动态代理:基于类,可以代理所有 public 方法(包括 final 方法除外)

Spring Boot 从 2.0 开始,spring.aop.proxy-target-class=true 是默认值,也就是说默认就用 CGLIB 代理具体类。你写接口反而要多写一层 Impl,换来的是 JDK 代理——但 JDK 代理的功能 CGLIB 全都有,还不需要接口。

那为什么还有人坚持要接口?历史原因:Spring 早期版本默认用 JDK 动态代理,那时没有接口就无法实现事务/AOP。但那是 2013 年以前的事了。现在的 Spring Boot 项目,你完全可以不写接口,把精力留给真正的业务逻辑。

如果你还不放心,可以做一个实验:把项目里所有 XxxService 接口 + XxxServiceImpl 合并成一个 XxxService 具体类,跑一遍全部测试用例——结果应该全部通过。如果有个别失败,要么是因为用了 JDK 代理的特定行为(极少见),要么是你的代码本来就有问题。

五、不要一棍子打死~~~ 那什么时候得有interface接口?

不是要一棍子打死所有接口。下面这几种场景,接口必须留,而且是核心设计:

场景一:确实多实现(策略/通道)

public interface PaymentService {
    PayResult pay(PayCmd cmd);
    String channel();
}

@Component
public class AlipayService implements PaymentService { ... }

@Component
public class WechatPayService implements PaymentService { ... }

// 运行时按 channel 选实现
@Service
public class PaymentRouter {
    @Resource private List<PaymentService> services;

    public PayResult route(PayCmd cmd) {
        return services.stream()
            .filter(s -> s.channel().equals(cmd.getChannel()))
            .findFirst()
            .orElseThrow()
            .pay(cmd);
    }
}

这种从第一天就知道会有 N 个实现的,接口是灵魂,必须建。

场景二:跨模块/跨团队契约

比如你做一个二方库 risk-sdk 给其他业务线用,对外暴露 RiskChecker 接口——这时候接口是公开契约,别人可能自己写实现插进来。留。

场景三:SPI / 插件扩展点

Dubbo、Spring Factories、自定义 SPI 机制要求的扩展点,本来就是"未来会有第三方实现",留。

场景四:框架强制要求

少数老项目用 JDK 动态代理(@Transactional 走 ProxyFactory 默认模式),或者某些 RPC 框架要求接口先行——这种是被框架绑架,留着无妨,但要知道为什么留。

除此之外的一个 interface 一个 impl,都值得拷问一句:你凭什么存在?

六、一句收口

interface 是为多态而生,不是为"看起来规范"而生。

一个接口从头到尾只有一个实现,还铺得到处都是——这不叫面向接口编程,这叫用接口的壳,干着具体类的活,还多付了一倍的文件税。

DIP(依赖倒置)是好原则,但好原则用错了地方就是负担。抽象要付代价,代价要换回价值。换不回价值的抽象,就是耍流氓。

下次再想顺手敲一个 XxxService 接口 + XxxServiceImpl 实现之前,先问自己一句:

第二个实现,是谁?答不上来,就别建了。


💬 你们项目里有多少个"单接口实现"?评论区报个数,看看谁更惨。

觉得说到痛处了,点个「在看」。

posted on 2026-11-20 09:49  buguge  阅读(11)  评论(0)    收藏  举报