Spring/Kotlin中用private隐藏契约实现是否为不良编程实践？

这种做法不属于不良编程实践，反而贴合面向接口编程的核心设计思路，不过也存在一些需要根据场景调整的细节：

为什么这种做法是合理的 #

• 严格践行面向接口编程：依赖注入的是MyService接口而非具体实现，调用方（比如MyController）只需要关注接口定义的契约，完全不用关心内部实现逻辑，大幅降低了代码耦合度。
• 从根源避免误用：把实现类设为private后，其他代码根本没法直接引用MyServiceImpl，彻底杜绝了绕过接口直接依赖实现的坏味道，保证了依赖倒置原则的落地。
• 优化开发体验：IDE自动补全里不会出现无关的实现类，开发者能更聚焦于契约接口本身，减少选择干扰，提升开发效率。

需要注意的局限性 #

• 跨包复用受限：如果后续同一模块的其他包需要复用这个实现类的逻辑，private修饰会导致无法直接访问，这时可以换成Kotlin的internal修饰符（包级私有），既限制跨模块访问，又保留包内复用的灵活性。
• 单元测试略有不便：如果需要单独测试MyServiceImpl的私有逻辑（不推荐直接测私有方法，但特殊场景可能需要），或者在测试中手动注入该实现，private修饰会增加测试难度。这种情况可以用internal配合@VisibleForTesting注解，或者通过Kotlin的测试模块可见性配置来解决。

示例代码 #

interface MyService {
    fun process()
}

@Service
private class MyServiceImpl : MyService { // 隐藏实现类
    override fun process() {
        println("Processing...")
    }
}

@RestController
class MyController(private val myService: MyService) {
    @GetMapping("/process")
    fun process() = myService.process()
}

内容的提问来源于stack exchange，提问作者ARTWIN