Spring to Solon Migration Skill
Provide expert guidance for migrating Java projects from Spring Boot / Spring Cloud to the Solon framework. Solon is an independent Java enterprise framework (NOT based on Spring) that offers similar developer experience but with different annotations, architecture, and ecosystem.
Official comparison: https://solon.noear.org/article/compare-springboot
Official cloud comparison: https://solon.noear.org/article/compare-springcloud
Solon website: https://solon.noear.org
Current version: 3.10.x
Critical Migration Rules
- Solon is NOT Spring. Never mix Spring annotations with Solon annotations. Replace ALL Spring imports.
- No Spring dependencies. Remove all
spring-boot-starter-*, spring-* artifacts. Solon uses org.noear group ID.
- Configuration file is
app.yml (or app.properties), NOT application.yml.
- Entry point is
Solon.start(App.class, args), NOT SpringApplication.run().
- Parent POM is
solon-parent with groupId=org.noear.
- Package scan uses
@Import on main class, NOT @ComponentScan.
- No setter injection. Solon only supports field injection and constructor injection.
- All examples target Solon 3.10.x unless specified otherwise.
- 中文支持. When the user communicates in Chinese, all responses and code comments must be in Chinese.
Migration Scene Navigation
根据迁移场景，读取对应的 reference 文件获取详细信息。
快速对照
| Scenario | Reference File | Grep Keywords |
|---|
| 注解替换对照表 / 完整的 Spring→Solon 注解映射 | references/annotation_mapping.md | @Autowired, @Inject, @RequestMapping, @Mapping, @Service, @Component, @Value |
| Maven 依赖替换 / starter → solon 插件 / POM 改造 | references/dependency_mapping.md | pom.xml, spring-boot-starter, solon-web, solon-lib, solon-parent |
IoC / AOP / 配置
| Scenario | Reference File | Grep Keywords |
|---|
| IoC 容器 / DI / 组件注册 / 作用域 / 生命周期 / AOP / 事件 / 包扫描 | references/ioc_aop_migration.md | @Inject, @Configuration, @Bean, LifecycleBean, @Init, @Destroy, @Aspect, EventBus |
| 配置文件 / 属性注入 / 配置类 / Bean 定义 / 条件装配 | references/config_system_migration.md | app.yml, @Inject("${"), @Configuration, @Bean, @Condition, solon.config |
Web 层迁移
| Scenario | Reference File | Grep Keywords |
|---|
| Controller / 请求参数 / 返回值 / Context 上下文 | references/web_controller_migration.md | @Controller, @RestController, @Mapping, @Param, @Body, Context |
| Filter / Interceptor / 全局异常 / CORS | references/web_filter_interceptor_migration.md | Filter, RouterInterceptor, @ControllerAdvice, GlobalExceptionFilter, @CrossOrigin |
| 文件上传下载 / SSE / WebSocket / 参数校验 / 会话 | references/web_advanced_migration.md | UploadedFile, SseEmitter, WebSocket, @Valid, SessionState |
数据访问迁移
| Scenario | Reference File | Grep Keywords |
|---|
| 数据源 / MyBatis / MyBatis Plus / JPA / 多数据源 | references/datasource_orm_migration.md | @Db, SqlUtils, MyBatis, JPA, HikariDataSource, @Mapper |
| 事务 / 缓存 / Redis / 陷阱清单 | references/transaction_cache_migration.md | @Transaction, @Cache, Redis, @CacheRemove, CacheService |
微服务迁移
| Scenario | Reference File | Grep Keywords |
|---|
| 注册发现 / 配置中心 / 陷阱清单 | references/cloud_discovery_config_migration.md | Nacos, Eureka, CloudClient, @CloudConfig, discovery, config |
| RPC (Feign→Nami) / 网关 / 事件消息 | references/cloud_gateway_rpc_migration.md | Feign, NamiClient, CloudGateway, @CloudEvent, Gateway |
| 断路器 / 任务调度 / 链路追踪 / 分布式锁/ID/文件/名单/监控/日志 | references/cloud_observability_migration.md | Breaker, @CloudJob, Trace, CloudLock, CloudId, CloudFile, Metric |
测试迁移
| Scenario | Reference File | Grep Keywords |
|---|
| 依赖 / 测试类 / HTTP 测试 / 配置 / Mock / 事务回滚 | references/test_basics_migration.md | @SpringBootTest, @SolonTest, HttpTester, Mock, @TestRollback |
| 切面 / 条件 / 生命周期 / WebFlux / 数据层 / 完整示例 / 陷阱 | references/test_advanced_migration.md | @Rollback, WebFlux, @SolonTest, @EnableAutoConfiguration, assert |
Quick Migration Checklist
Step 1: POM 改造
- Replace
spring-boot-starter-parent → solon-parent
- Replace Spring starters → Solon plugins
- Add
solon-maven-plugin
- See:
references/dependency_mapping.md
Step 2: 配置文件
- Rename
application.yml → app.yml
- Adjust configuration key names
- See:
references/config_system_migration.md
Step 3: 启动类
- Replace
@SpringBootApplication → @SolonMain
- Replace
SpringApplication.run() → Solon.start()
- See:
references/annotation_mapping.md
Step 4: 注解替换
- Replace all Spring annotations with Solon equivalents
- See:
references/annotation_mapping.md
Step 5: Web 层改造
- Replace
@RestController → @Controller
- Replace
@RequestMapping → @Mapping
- Handle
HttpServletRequest/Response → Context
- See:
references/web_controller_migration.md
Step 6: 数据层改造
- Replace Spring transaction/cache annotations
- See:
references/datasource_orm_migration.md, references/transaction_cache_migration.md
Step 7: 微服务改造 (如适用)
- Replace Spring Cloud components with Solon Cloud equivalents
- See:
references/cloud_discovery_config_migration.md
Step 8: 测试改造
- Replace
@SpringBootTest → @SolonTest
- See:
references/test_basics_migration.md