技能介绍

在 Spring Boot 开发中，最常遇到的不是写某个具体业务逻辑，而是把一套项目快速跑起来、跑在另一台机器或另一个仓库时还能保持约定一致。手动搭建时容易出现绝对路径写死、数据库连接硬编码、包名不统一等问题，导致项目在不同环境间迁移时需要大量调整；分层架构里 Controller 返回格式混乱、全局异常处理缺失，后续维护成本高；启动失败排查靠经验，缺少统一清单；性能调优参数也常凭感觉设置，没有明确依据。

这个技能以「零硬编码、可迁移」为核心，先解决环境与项目的解耦。它只用 src/main/java/... 这样的相对路径，默认 8080 端口但支持 server.port 配置，数据库连接通过 spring.datasource.url 自动检测，包名用 ${basePackage} 占位符表示，配合 java -version、mvn -v 做工具链环境检测。

项目初始化支持 Spring Initializr（推荐）和 Maven 手动创建两种方式，也包含检测现有项目的能力。架构层面，它定义了 ${basePackage} 的包名约定（如 com.example.demo），Controller 层提供 RESTful API 模板、统一返回格式与全局异常处理，Service 层与 Repository 层分别给出规范，Repository 同时覆盖 JPA 与 MyBatis-Plus。实体规范、配置规范（application.yml 模板）都通过环境变量覆盖默认值，避免硬编码真实密码。

常用集成部分包含 Redis 缓存、定时任务和 AOP 日志；测试规范与常用命令也被整理在内。性能调优用一张清单明确给出建议：HikariCP 连接池默认 10，生产可调到 20-50，spring.jpa.open-in-view=false 避免长连接持有数据库连接，server.tomcat.threads.max 默认 200，生产环境关闭 show-sql，热点数据加 Redis 缓存并按业务设置 TTL，非核心路径用 @EnableAsync 与 @Async 异步化，server.compression.enabled=true 减少带宽。

需要注意的是，${basePackage} 是占位符，实际使用时要替换成项目的根包名；所有路径都为相对路径，技能不绑定任何特定项目或机器；代码示例遵循 Spring Boot 3.x + Java 17 标准，同时兼容 Maven 与 Gradle 两种构建工具。常见问题排查也给出明确方向：启动失败先查数据库连接、端口占用、Bean 冲突、循环依赖与版本冲突，接口 404 要检查路径拼写、包扫描范围与 context-path，事务不回滚也有单独章节。