Spring Boot → Solon 注解迁移实战指南：一张对照表说清楚

一、写在前面

如果你会 Spring Boot，那你已经会了一大半 Solon。

Solon 不是 Spring 的分支或封装，它是独立发展的全栈应用开发框架。但在设计哲学上，Solon 遵循了 Java 主流的 IoC、AOP、MVC 范式——概念相同，注解名不同。

这篇文章把 Spring Boot 到 Solon 的注解映射、配置迁移、关键差异整理成对照表，供迁移参考。

二、IoC/DI 容器：注解对照

核心原则：Solon 将 Spring 的多个细分注解合并为少数几个核心注解。

2.1 组件注册

2.2 依赖注入

注意：Solon 的@Inject一个注解兼顾了 Spring 中@Autowired、@Qualifier、@Value三个注解的功能。

2.3 生命周期与作用域

三、Web 层：Controller 改写

3.1 注解映射

3.2 Before / After 示例

Spring Boot 写法：

@RestController @RequestMapping("/users") public class UserController { @Autowired private UserService userService; @GetMapping("/{id}") public User getUser(@PathVariable Long id) { return userService.findById(id); } @PostMapping public User create(@RequestBody User user) { return userService.save(user); } }

Solon 写法：

@Controller @Mapping("/users") public class UserController { @Inject private UserService userService; @Get @Mapping("/{id}") public User getUser(@Path Long id) { return userService.findById(id); } @Post @Mapping public User create(@Body User user) { return userService.save(user); } }

3.3 关键差异：Context 替代 Servlet API

Solon不依赖 Servlet 容器，因此HttpServletRequest/HttpServletResponse需替换为Context：

// Spring 写法 public User get(HttpServletRequest request) { String token = request.getHeader("Token"); String id = request.getParameter("id"); } // Solon 写法 public User get(Context ctx) { String token = ctx.header("Token"); String id = ctx.param("id"); // ctx.redirect(url) 重定向 // ctx.render(obj) 渲染 // ctx.remoteIp() 客户端 IP }

⚠️Context只能在方法参数中注入，不能作为字段注入。

四、配置文件迁移

4.1 文件命名

4.2 常用配置键名对照

⚠️ Solon 配置键名统一使用驼峰命名（contextPath），不是短横线（context-path）。

五、数据访问：@Db 一站式注入

5.1 多数据源配置（YAML）

solon.dataSources: db1: class: com.zaxxer.hikari.HikariDataSource url: jdbc:mysql://localhost/test driverClassName: com.mysql.cj.jdbc.Driver username: root password: 123456 db2: url: jdbc:mysql://localhost/order driverClassName: com.mysql.cj.jdbc.Driver username: root password: 123456

5.2 @Db 注入

// Solon 一行搞定多数据源 @Db("db1") UserMapper userMapper; @Db("db2") OrderMapper orderMapper;

对比 Spring Boot 多数据源需要配置：多个DataSource+ 多个SqlSessionFactory+ 多个TransactionManager+@MapperScan...Solon 使用@Db。

5.3 ORM 集成

5.4 事务

Solon 的@Transaction默认遇到任何异常都回滚，无需指定异常类型。

六、测试迁移

HttpTester 用法示例：

@SolonTest(App.class) public class UserControllerTest extends HttpTester { @Test public void testGetUser() { // GET 请求 String resp = path("/users/1").get(); assertEquals(200, resp.code()); // POST 请求 String json = "{\"name\":\"test\"}"; String resp2 = path("/users").body(json).post(); assertContains(resp2, "test"); } }

七、其他常见对照

八、迁移检查清单

• POM：spring-boot-starter-parent→solon-parent
• POM：spring-boot-starter-*→solon-*/*-solon-plugin
• 配置：application.yml→app.yml（环境文件同理）
• 启动类：@SpringBootApplication→@SolonMain
• 启动：SpringApplication.run()→Solon.start()
• IoC：@Autowired→@Inject
• IoC：@Service/@Repository→@Component
• Web：@RestController→@Controller
• Web：@RequestMapping→@Mapping
• Web：@PathVariable→@Path
• Web：HttpServletRequest→Context
• 配置：@Value→@Inject("${...}")
• 数据：spring.datasource.*→solon.dataSources.*
• 数据：@Transactional→@Transaction
• 测试：@SpringBootTest→@SolonTest
• 测试：MockMvc→HttpTester

九、写在最后

这篇对照表覆盖了日常开发中最常用的 90% 场景。Solon 的注解体系并非简单的"换皮"，它在统一性（@Component/@Inject/@Condition）和简便性（@Db/ 无需@RefreshScope）上做了明显的设计取舍。