360 Secure SkillHub
360 安全技能中心

spring-to-solon-skill

面向 Java 项目的框架迁移参考技能，按迁移场景组织 14 个 reference 文件，覆盖注解与依赖映射、IoC/AOP、配置系统、Web 层、数据访问、事务缓存、微服务与测试，给出对照表、代码示例与常见陷阱，指导将 Spring Boot/Spring Cloud 项目改写为 Solon 3.10.x。

noear
noear
热度 35.76
最近更新 2026-05-11 17:43:14
分类：开发依赖：纯提示词应用场景：代码生成 / 模板 / 工作流 / 概念解释

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add spring-to-solon-skill
Metadata
name
spring-to-solon-skill
description
Expert guidance for migrating Java projects from Spring Boot / Spring Cloud to the Solon framework. Provides comprehensive annotation mapping, dependency replacement, architecture differences, and step-by-step migration strategies for each layer (IoC, Web, Data, Cloud, Testing).

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

  1. Solon is NOT Spring. Never mix Spring annotations with Solon annotations. Replace ALL Spring imports.
  2. No Spring dependencies. Remove all spring-boot-starter-*, spring-* artifacts. Solon uses org.noear group ID.
  3. Configuration file is app.yml (or app.properties), NOT application.yml.
  4. Entry point is Solon.start(App.class, args), NOT SpringApplication.run().
  5. Parent POM is solon-parent with groupId=org.noear.
  6. Package scan uses @Import on main class, NOT @ComponentScan.
  7. No setter injection. Solon only supports field injection and constructor injection.
  8. All examples target Solon 3.10.x unless specified otherwise.
  9. 中文支持. 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