spring-to-solon-skill

Spring to Solon Migration Skill

为将 Spring Boot / Spring Cloud 项目迁移到 Solon 框架 提供专家指导。Solon 是独立的 Java 企业框架（不基于 Spring），开发体验相近，但注解、架构与生态不同。

官方对照: https://solon.noear.org/article/compare-springboot
Cloud 对照: https://solon.noear.org/article/compare-springcloud
官网: https://solon.noear.org
当前版本: 4.0.3

版本声明：本文档所有示例基于 Solon 4.0.3（最后一次确认: 2026-07）。如需迁移到其他版本，请调整对应版本号。Solon 高版本保持向后兼容，通常仅需修改 solon-parent 版本号即可。reference 内写「跟随 SKILL 目标版本」时，以本节为准。

Critical Migration Rules

1. Solon 不是 Spring。 禁止混用 Spring 注解与 Solon 注解。替换全部 Spring import。
2. 禁止 Spring 依赖。 移除所有 spring-boot-starter-*、spring-*。Solon 使用 org.noear groupId。
3. 配置文件是 app.yml（或 app.properties），不是 application.yml。
4. 入口是 Solon.start(App.class, args)，不是 SpringApplication.run()。
5. Parent POM 是 solon-parent（groupId=org.noear）。
6. 包扫描在主类用 @Import / 主类包路径，不是 @ComponentScan。
7. 无 setter 注入。 Solon 只支持字段注入与构造器注入；构造器参数必须显式 @Inject。
8. 组件用 @Component，不要用 @Service / @Repository。
9. 所有示例目标 Solon 4.0.x（默认 4.0.3），除非用户指定其它版本。
10. 中文支持。 用户使用中文时，回复与代码注释使用中文。
11. 不确定的 API 不要臆造。 对照本 skill reference；Solon 原生细节查 solon-development-skill。
12. 校验坐标 为 solon-security-validation（不是 solon-validation）。类级启用 @Valid，实体参数/字段用 @Validated。
13. 调度选型：单机 → @Scheduled（scheduling_migration.md）；分布式防重 → @CloudJob（cloud_observability_migration.md）。勿一律替换。

与 solon-development-skill 的边界

场景	使用 skill
Spring → Solon 对照、替换、迁移步骤	本 skill
纯 Solon 新功能 / AI / Flow / 最佳实践	solon-development-skill
两边都提及时	先按本 skill 完成迁移对照，再链开发 skill 补原生写法

执行流程

1. 扫项目：父 POM、starter 列表、配置文件名、启动类、测试入口、是否有 Security / Validation / Scheduling / Cloud。
2. 按 Checklist Step 1→12 推进；每步只 read 1～2 个 reference，避免一次加载全部。
3. 生成代码前核对 Critical Migration Rules（尤其：app.yml、无 Spring 混用、@Component/@Inject、校验坐标）。
4. 数据层优先 datasource_orm_migration.md（含 solon.dataSources、SqlUtils、@Db）。
5. 安全优先 security_migration.md（不要复刻完整 Spring Security 过滤器链）。
6. 校验优先 validation_migration.md（与 web_advanced 摘要冲突时以 validation 文为准）。
7. 迁移完成后的 Solon 深化（AI/Flow/进阶 API）交给 solon-development-skill。