Java Fullstack Development Engine

--- name: java-fullstack-engine description: Java全栈开发专家决策引擎。提供项目类型路由(Web后端/微服务/游戏服务器/数据处理/Android)、框架决策树(Spring Boot/Quarkus/Micronaut)、Spring Boot 3.x最佳实践、JVM调优矩阵、分布式架构决策(单体vs微服务)、质量门控三级清单、10个常见错误模式。当用户需要Java开发、Spring Boot、后端开发、微服务架构、JVM调优、游戏服务器、Java fullstack时使用此技能 --- # Java全栈开发决策引擎 > 专家级决策系统——不是教Java语法，而是帮你在架构选型、性能瓶颈、分布式陷阱等关键岔路做正确决策。 ## 项目类型路由器 ## 框架决策树 ### Spring Boot vs Quarkus vs Micronaut | 维度 | Spring Boot 3.x | Quarkus | Micronaut | |------|----------------|---------|-----------| | 启动时间 | 2-5s | 0.04-0.1s(原生) | 0.5-1s | | 内存占用 | 200-500MB | 30-80MB(原生) | 50-120MB | | 生态成熟度 | ★★★★★ | ★★★☆ | ★★★☆ | | 原生镜像 | GraalVM支持(需适配) | 原生优先 | GraalVM支持 | | 学习曲线 | 低(文档最全) | 中 | 中 | | **推荐场景** | 企业级/团队协作 | Serverless/云原生 | 微服务/轻量 | **决策规则**: - 团队>5人且已有Spring经验 → Spring Boot（不要为了新技术增加团队学习成本） - Serverless/K8s环境且QPS波动大 → Quarkus（原生镜像冷启动优势） - 游戏后端/高并发长连接 → Netty + Spring Boot（Netty管IO，Spring管业务） ### Spring Boot 3.x关键实践 1. **虚拟线程(Loom)**: `spring.threads.virtual.enabled=true` — IO密集型吞吐提升3-5x，但synchronized锁会pin载线程，必须改用ReentrantLock 2. **GraalVM原生镜像**: 限制——反射需显式注册、动态代理需配置、CGLIB不可用(改用接口代理) 3. **Observability**: Micrometer + Zipkin/Jaeger链路追踪开箱即用，不要自己造轮子 4. **Flyway vs Liquibase**: Flyway更适合SQL-first团队；Liquibase支持XML/YAML/JSON多格式+回滚 ## JVM调优矩阵 ### GC选择决策 | 场景 | 推荐GC | 关键参数 | 原因 | |------|--------|----------|------| | 低延迟(<10ms) | ZGC | `-XX:+UseZGC -Xmx4g -XX:ZAllocationSpikeTolerance=2` | 亚毫秒停顿 | | 大堆(>16GB) | ZGC/G1 | ZGC:同上; G1:`-XX:+UseG1GC -XX:MaxGCPauseMillis=100` | ZGC无堆限制; G1需调Region | | 游戏服务器 | ZGC | 同上+`-XX:+UnlockExperimentalVMOptions -XX:+UseZGC -XX:ZCollectionInterval=0` | 严苛延迟要求 | | 批处理/离线 | Parallel | `-XX:+UseParallelGC -XX:ParallelGCThreads=8` | 吞吐优先 | | 默认/通用 | G1 | `-XX:+UseG1GC` | 平衡之选 | ### 内存泄漏排查清单 1. `jmap -histo:live ` 查对象分布 — 关注自定义类数量异常 2. `jcmd GC.heap_info` 查各代使用 — Old Gen持续增长=泄漏 3. MAT分析dump — Dominator Tree找最大保留集 4. 常见元凶: ThreadLocal未remove、缓存无过期、监听器未注销、大对象DirectByteBuffer未释放 ## 分布式架构决策 ### 单体 vs 微服务 **微服务拆分陷阱**: - 不要按技术层拆(用户Service、订单Service是错的) → 按业务域拆 - 不要一步到位 → 先单体后拆，拆了再合比合了再拆难100倍 - 不要忽略分布式事务 → 先接受最终一致性，Saga > TCC > 2PC ### 游戏服务器架构专项 **关键设计**: - 协议: Protobuf > JSON（体积小3-5x，解析快10x）— 但开发阶段可用JSON调试 - 状态同步: 帧同步(确定性逻辑) vs 状态同步(服务器权威) — 休闲游戏用状态同步，竞技游戏用帧同步 - 断线重连: 服务器缓存最近N帧状态，客户端重连后快进 ## 质量门控三级清单 ### L1-必须(阻塞发布) - [ ] 单元测试覆盖率≥60%(核心业务≥80%) - [ ] 所有API有Swagger/OpenAPI文档 - [ ] 敏感配置不在代码中(环境变量/配置中心) - [ ] 数据库迁移脚本可重复执行(Flyway baseline) - [ ] 日志规范: TRACE90% - [ ] 自动化性能回归测试 - [ ] 混沌工程(随机故障注入) ## 10个常见错误模式 1. **N+1查询**: MyBatis关联查询未用批量fetch — 用`@BatchSize`或手写JOIN 2. **事务过大**: `@Transactional`包裹远程调用 → 锁持有时间暴涨 — 远程调用移到事务外 3. **缓存穿透**: 热点Key失效瞬间DB被打爆 — 布隆过滤器+空值缓存+随机过期 4. **分布式锁不安全**: Redis SETNX无超时 → 死锁 — 必须带过期+Redisson看门狗 5. **线程池耗尽**: Tomcat线程被IO阻塞 — IO操作用虚拟线程或异步 6. **序列化陷阱**: Jackson默认行为与预期不符(日期/空值/循环引用) — 显式配置ObjectMapper 7. **微服务循环调用**: A→B→C→A → 全链路超时 — 引入事件驱动解耦 8. **数据库索引缺失**: 慢查询未监控 — 开启慢查询日志+Explain分析 9. **日志打爆磁盘**: 大对象toString()全量输出 — 生产环境脱敏+截断 10. **GraalVM兼容盲区**: 反射/动态代理/CGLIB在原生镜像中静默失败 — Native Image Test必须跑 ## 执行流程 1. **需求分析** → 用路由器确定项目类型 2. **技术选型** → 用决策树选择框架组合 3. **架构设计** → 用分布式决策确定服务边界 4. **实现指导** → 参考最佳实践和错误模式避坑 5. **质量验收** → 用门控清单逐项检查 ## 2026平台实战洞察 > 本章节整合深度行业调研数据，为Java全栈开发决策提供最新基准参考。 ### 关键数据点 #### 1. JDK版本关键纠正（必读） - **数据**: JDK 25是2025.9的LTS版本（非JDK 26），JDK 24已于2025.3.18发布 - **Spring Boot 4.0**: 2025.11.20正式发布，大量应用需迁移 - **决策影响**: 企业项目应规划JDK 25升级路线，新项目可直接使用 - **置信度**: [HIGH] - Oracle官方发布日历确认 #### 2. 虚拟线程(Loom)生产验证 - **数据**: IO密集型服务使用虚拟线程后吞吐量提升3-5x - **陷阱**: synchronized锁会导致线程pinning，需改用ReentrantLock - **最佳实践**: `spring.threads.virtual.enabled=true` + ReentrantLock替代synchronized - **置信度**: [HIGH] - Spring官方benchmark #### 3. GraalVM原生镜像成熟 - **启动时间**: 0.04-0.1s vs 传统JVM 2-5s - **内存占用**: 30-80MB vs 200-500MB - **限制**: 反射需显式注册、动态代理需配置、CGLIB不可用 - **推荐场景**: Serverless/K8s高频启停环境 - **置信度**: [HIGH] - GraalVM官方测试 #### 4. AI辅助Java开发 - **代码生成**: Claude Code在Java语法补全和重构建议上领先 - **测试辅助**: AI可自动生成JUnit测试用例，覆盖率提升20-30% - **代码审查**: AI可识别70%+常见性能反模式( N+1/大事务/连接池泄漏) - **置信度**: [MEDIUM] - JetBrains AI Assistant统计 #### 5. 微服务架构演进 - **趋势**: 2026年更多团队从微服务回归模块化单体 - **原因**: 微服务复杂度/成本 vs 业务收益不匹配 - **建议**: 团队<30人优先模块化单体，预留拆分接口 - **置信度**: [HIGH] - ThoughtWorks技术雷达 ### 决策建议 1. **新企业项目**: Spring Boot 4.0 + JDK 25 + 虚拟线程 2. **Serverless场景**: Quarkus + GraalVM原生镜像 3. **游戏后端**: Netty + Spring Boot(业务层)，坚守Protobuf协议 4. **GC选型**: 低延迟游戏服务用ZGC，批处理用Parallel 5. **AI集成**: 从代码审查开始，逐步引入测试生成和文档辅助 --- ## 深度技术详解篇 --- ### 一、项目类型路由深度决策矩阵 #### 1.1 Web后端（CRUD/BFF层）完整决策树 **推荐技术栈组合（按场景细分）**: | 场景 | 核心框架 | ORM | 数据库 | 缓存 | 消息队列 | 网关 | |------|----------|-----|--------|------|---------|------| | 电商后台 | Spring Boot 3.x | MyBatis-Plus | MySQL 8.0 | Redis Cluster | RocketMQ | Spring Cloud Gateway | | 社交平台 | Spring Boot 3.x | JPA | PostgreSQL | Redis + MongoDB | Kafka | 自研/Envoy | | 企业SaaS | Spring Boot 3.x | MyBatis-Plus | MySQL | Redis | RabbitMQ | Kong | | 内容CMS | Spring Boot 3.x | JPA | MySQL | Redis | 无（同步即可） | Nginx | | 数据报表 | Spring Boot 3.x | MyBatis | ClickHouse | 无 | Kafka | 自研 | #### 1.2 微服务架构（>5个服务域）完整路由 **微服务通信模式决策**: | 通信模式 | 适用场景 | 框架选择 | 注意事项 | |----------|----------|----------|----------| | 同步REST | 低延迟、强一致性 | RestTemplate/WebClient/Feign | 设置超时+重试+熔断 | | 同步gRPC | 高性能、内部通信 | grpc-spring-boot | 需要proto定义管理 | | 异步消息 | 解耦、最终一致 | Kafka/RocketMQ/RabbitMQ | 消息幂等+顺序保证 | | 事件驱动 | 跨服务状态同步 | Spring Cloud Stream | CQRS模式配合 | #### 1.3 游戏服务器（实时交互）专项路由 **游戏服务器协议选型**: | 协议 | 序列化效率 | 开发效率 | 跨语言支持 | 适用场景 | |------|------------|----------|------------|----------| | Protobuf | 高（~3x JSON） | 中 | 优秀 | 正式环境、追求性能 | | JSON | 中 | 高 | 优秀 | 开发调试、简单场景 | | FlatBuffers | 最高 | 低 | 中 | 超高频更新（帧同步） | | MessagePack | 中高 | 高 | 优秀 | 平衡场景 | | 自定义二进制 | 最高 | 低 | 差 | 特殊优化需求 | #### 1.4 数据处理（批处理/流处理）专项路由 #### 1.5 Android（Kotlin移动开发）专项路由 --- ### 二、框架决策树深度解析 #### 2.1 Spring Boot 3.x vs Quarkus vs Micronaut 完整对比 **性能基准数据（2025-2026实测）**: | 指标 | Spring Boot 3.2 | Quarkus 3.8 | Micronaut 4.3 | |------|-----------------|-------------|---------------| | 冷启动时间（JVM） | 2.5-5s | 1.5-2.5s | 0.8-1.5s | | 冷启动时间（Native） | 0.5-1s | 0.03-0.08s | 0.1-0.3s | | 内存占用（JVM） | 200-500MB | 150-300MB | 100-200MB | | 内存占用（Native） | 50-100MB | 25-50MB | 30-60MB | | QPS（简单CRUD） | 15000-25000 | 20000-35000 | 18000-30000 | | 生态插件数量 | 5000+ | 800+ | 600+ | | 中文文档完整度 | ★★★★★ | ★★☆☆☆ | ★★☆☆☆ | | 社区活跃度 | ★★★★★ | ★★★★☆ | ★★★☆☆ | **选型决策树**: **选型公式**: #### 2.2 Spring Boot 3.x 深度最佳实践 **2.2.1 自动配置原理（@EnableAutoConfiguration深层机制）** **2.2.2 启动优化（从5秒到1秒的实战技巧）** **2.2.3 安全配置（Spring Security 6.x新特性）** **2.2.4 GraalVM原生镜像完整配置指南** --- ### 三、JVM调优矩阵深度解析 #### 3.1 垃圾收集器完整决策矩阵 **GC参数速查表**: | GC类型 | JVM参数 | 适用场景 | 停顿时间 | 吞吐量 | 内存占用 | |--------|---------|----------|----------|--------|----------| | Serial | -XX:+UseSerialGC | 单核、极小堆(<100MB) | 较长 | 最高 | 最低 | | Parallel | -XX:+UseParallelGC | 批处理、离线计算 | 中等 | 最高 | 低 | | G1 | -XX:+UseG1GC | 通用场景（默认） | 可控(MAX_GC_PAUSE_MILLIS) | 高 | 中 | | ZGC | -XX:+UseZGC | 低延迟、大内存 | <1ms | 高 | 略高 | | Shenandoah | -XX:+UseShenandoahGC | 低延迟、容器 | <1ms | 高 | 略高 | | Epsilon | -XX:+UseEpsilonGC | 短生命周期、微服务 | 无GC | 最高 | 最低 | **G1调优进阶参数**: **ZGC深度调优**: #### 3.2 内存模型与调优 **内存配置公式**: **常见内存问题诊断**: #### 3.3 线程池配置公式 **Spring Boot线程池配置**: **使用示例**: #### 3.4 JFR（Java Flight Recorder）监控实战 **JMC（Java Mission Control）分析要点**: --- ### 四、分布式架构深度决策 #### 4.1 单体 vs 微服务 vs 模块化单体决策树 **模块化单体实施模板**: #### 4.2 服务治理完整方案 **Spring Cloud Alibaba全套件选型**: | 功能 | 组件 | 备选 | 说明 | |------|------|------|------| | 服务注册/发现 | Nacos | Consul/Zookeeper | Nacos还支持配置中心 | | 负载均衡 | LoadBalancer | Feign/OpenFeign | Spring原生 | | 限流/熔断 | Sentinel | Resilience4j | Sentinel Dashboard可视化 | | 分布式事务 | Seata | ByteTCC | AT模式最简单 | | 网关 | Spring Cloud Gateway | Kong/Envoy | 响应式编程 | | 配置中心 | Nacos | Apollo/Consul | 支持热刷新 | | 消息队列 | RocketMQ | Kafka/RabbitMQ | 事务消息支持 | | 分布式锁 | Redisson | Redis SETNX | 支持看门狗自动续期 | #### 4.3 分布式事务模式深度对比 **Seata AT模式（推荐，最简单）**: **Saga模式（长流程编排）**: **消息队列最终一致性方案**: #### 4.4 链路追踪完整方案 **Spring Cloud Sleuth + Zipkin集成**: **自定义链路追踪字段**: --- ### 五、2026年Java生态趋势深度解读 #### 5.1 Virtual Threads（Loom）生产实践 **Virtual Threads vs Platform Threads对比**: | 维度 | Virtual Threads | Platform Threads | |------|-----------------|------------------| | 创建成本 | 微秒级（几乎无限制） | 毫秒级（几百毫秒） | | 内存占用 | ~300B-1KB | ~1MB | | 最佳场景 | IO密集、高并发 | CPU密集、计算 | | 阻塞影响 | 不阻塞OS线程 | 占用OS线程 | | 调试 | 堆栈可能截断 | 完整堆栈 | | 线程dump | 分析更复杂 | 标准分析 | **Spring Boot虚拟线程配置**: #### 5.2 GraalVM原生镜像2026状态 **原生镜像构建最佳实践**: **原生镜像调试技巧**: #### 5.3 云原生Java新范式 **Docker容器化最佳实践**: #### 5.4 响应式与协程融合趋势 **WebFlux vs Spring MVC选择决策**: --- ### 六、10个常见错误模式深度诊断与修复 #### 错误1: N+1查询问题 #### 错误2: 事务边界过大 #### 错误3: 缓存穿透/击穿/雪崩 #### 错误4: 分布式锁不安全 #### 错误5: 线程池配置不当 #### 错误6: JSON序列化配置混乱 #### 错误7: 微服务循环依赖 #### 错误8: 数据库索引缺失/滥用 #### 错误9: 日志打爆磁盘 #### 错误10: GraalVM兼容盲区 --- ### 七、质量门控深度清单 #### L1级检查项（阻塞发布，必须全部通过） #### L2级检查项（版本内完成） #### L3级检查项（持续改进） --- ### 八、实战案例索引 #### 案例1: 电商订单系统完整实现 #### 案例2: 游戏服务器完整实现 #### 案例3: 数据处理平台完整实现 --- ### 九、术语表与参考资源 #### 核心术语表 | 术语 | 全称 | 解释 | |------|------|------| | JVM | Java Virtual Machine | Java字节码运行时 | | GC | Garbage Collection | 垃圾回收 | | JFR | Java Flight Recorder | JVM诊断工具 | | JIT | Just-In-Time Compiler | 即时编译器 | | AOT | Ahead-Of-Time | 预编译 | | CDI | Contexts and Dependency Injection | 依赖注入规范 | | SPI | Service Provider Interface | 服务提供接口 | | JPA | Java Persistence API | Java持久化API | | ORM | Object-Relational Mapping | 对象关系映射 | | DTO | Data Transfer Object | 数据传输对象 | | CQRS | Command Query Responsibility Segregation | 命令查询职责分离 | | ES | Event Sourcing | 事件溯源 | | CDC | Change Data Capture | 变更数据捕获 | #### 官方文档参考 --- ## 执行流程（完整版） --- ## 总结 本技能文档提供了Java全栈开发从0到1的完整决策体系： 1. **项目类型路由** → 快速定位适合的技术架构 2. **框架决策树** → 选择最适合的框架组合 3. **Spring Boot最佳实践** → 高质量编码规范 4. **JVM调优矩阵** → 性能问题诊断与优化 5. **分布式架构** → 微服务设计模式与陷阱 6. **2026趋势** → 跟上技术演进节奏 7. **错误模式** → 常见问题诊断与修复 8. **质量门控** → 全方位质量保障 使用建议： - 遇到技术选型问题 → 先查「项目类型路由」 - 遇到性能问题 → 查「JVM调优矩阵」和「错误模式」 - 遇到架构问题 → 查「分布式架构决策」 - 上线前检查 → 使用「质量门控清单」 持续更新：每季度根据Java生态演进更新本技能文档。