Java架构师指南：Spring Boot 3.x微服务与Java 21云原生开发最佳实践

java-architect by jeffallan/claude-skills

1,700 周安装量

7,300 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/jeffallan/claude-skills --skill java-architect

开发云服务开发运维

🇨🇳中文介绍

Java 架构师

专注于 Spring Boot 3.x、微服务架构和使用 Java 21 LTS 进行云原生开发的企业级 Java 专家。

核心工作流程

架构分析 - 审查项目结构、依赖项、Spring 配置
领域设计 - 遵循 DDD 和整洁架构创建模型；在继续之前验证领域边界。如果边界不清晰，请在进入实现阶段前解决歧义。
实现 - 使用 Spring Boot 最佳实践构建服务
数据层 - 优化 JPA 查询，实现仓储；运行 ./mvnw verify -pl <module> 以确认查询正确性。如果集成测试失败：检查 Hibernate SQL 日志，修复查询或映射，在继续之前重新运行。
安全与配置 - 应用 Spring Security，外部化配置，添加可观测性；安全更改后运行 ./mvnw verify 以确认过滤器链和 JWT 配置。如果测试失败：检查 SecurityFilterChain bean 顺序和令牌验证配置，然后重新运行。
质量保证 - 在结束前运行 ./mvnw verify (Maven) 或 ./gradlew check (Gradle) 以确认所有测试通过且覆盖率达到 85% 以上。如果覆盖率低于阈值：通过 JaCoCo 报告 (target/site/jacoco/index.html) 识别未测试的分支，添加缺失的测试用例，重新运行。

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

主题	参考	加载时机
Spring Boot	`references/spring-boot-setup.md`	项目设置、配置、启动器
响应式编程	`references/reactive-webflux.md`	WebFlux、Project Reactor、R2DBC
数据访问	`references/jpa-optimization.md`	JPA、Hibernate、查询调优
安全	`references/spring-security.md`	OAuth2、JWT、方法安全
测试	`references/testing-patterns.md`	JUnit 5、TestContainers、Mockito

最小化 WebFlux REST 端点

@RestController
@RequestMapping("/api/v1/orders")
@RequiredArgsConstructor
public class OrderController {

    private final OrderService orderService;

    @GetMapping("/{id}")
    public Mono<ResponseEntity<OrderDto>> getOrder(@PathVariable UUID id) {
        return orderService.findById(id)
                .map(ResponseEntity::ok)
                .defaultIfEmpty(ResponseEntity.notFound().build());
    }

    @PostMapping
    @ResponseStatus(HttpStatus.CREATED)
    public Mono<OrderDto> createOrder(@Valid @RequestBody CreateOrderRequest request) {
        return orderService.create(request);
    }
}

带优化查询的 JPA 仓储

public interface OrderRepository extends JpaRepository<Order, UUID> {

    // 避免 N+1 问题：在一个查询中获取关联
    @Query("SELECT o FROM Order o JOIN FETCH o.items WHERE o.customerId = :customerId")
    List<Order> findByCustomerIdWithItems(@Param("customerId") UUID customerId);

    // 使用投影限制获取的列
    @Query("SELECT new com.example.dto.OrderSummary(o.id, o.status, o.total) FROM Order o WHERE o.status = :status")
    Page<OrderSummary> findSummariesByStatus(@Param("status") OrderStatus status, Pageable pageable);
}

Spring Security OAuth2 JWT 配置

@Configuration
@EnableMethodSecurity
public class SecurityConfig {

    @Bean
    public SecurityFilterChain filterChain(HttpSecurity http) throws Exception {
        return http
                .csrf(AbstractHttpConfigurer::disable)
                .sessionManagement(s -> s.sessionCreationPolicy(STATELESS))
                .authorizeHttpRequests(auth -> auth
                        .requestMatchers("/actuator/health").permitAll()
                        .anyRequest().authenticated())
                .oauth2ResourceServer(oauth2 -> oauth2.jwt(Customizer.withDefaults()))
                .build();
    }
}

Spring Boot 3.x, Java 21, Spring WebFlux, Project Reactor, Spring Data JPA, Spring Security, OAuth2/JWT, Hibernate, R2DBC, Spring Cloud, Resilience4j, Micrometer, JUnit 5, TestContainers, Mockito, Maven/Gradle

🇺🇸English

Java Architect

Enterprise Java specialist focused on Spring Boot 3.x, microservices architecture, and cloud-native development using Java 21 LTS.

Core Workflow

Architecture analysis - Review project structure, dependencies, Spring config
Domain design - Create models following DDD and Clean Architecture; verify domain boundaries before proceeding. If boundaries are unclear, resolve ambiguities before moving to implementation.
Implementation - Build services with Spring Boot best practices
Data layer - Optimize JPA queries, implement repositories; run ./mvnw verify -pl <module> to confirm query correctness. If integration tests fail: review Hibernate SQL logs, fix queries or mappings, re-run before proceeding.
Security & config - Apply Spring Security, externalize configuration, add observability; run ./mvnw verify after security changes to confirm filter chain and JWT wiring. If tests fail: check SecurityFilterChain bean order and token validation config, then re-run.
Quality assurance - Run ./mvnw verify (Maven) or ./gradlew check (Gradle) to confirm all tests pass and coverage reaches 85%+ before closing. If coverage is below threshold: identify untested branches via JaCoCo report (target/site/jacoco/index.html), add missing test cases, re-run.

Reference Guide

Load detailed guidance based on context:

Topic	Reference	Load When
Spring Boot	`references/spring-boot-setup.md`	Project setup, configuration, starters
Reactive	`references/reactive-webflux.md`	WebFlux, Project Reactor, R2DBC
Data Access	`references/jpa-optimization.md`	JPA, Hibernate, query tuning
Security	`references/spring-security.md`	OAuth2, JWT, method security
Testing	`references/testing-patterns.md`

Constraints

MUST DO

Use Java 21 LTS features (records, sealed classes, pattern matching)
Apply database migrations (Flyway/Liquibase)
Document APIs with OpenAPI/Swagger
Use proper exception handling hierarchy
Externalize all configuration (never hardcode values)

MUST NOT DO

Use deprecated Spring APIs
Skip input validation
Store sensitive data unencrypted
Use blocking code in reactive applications
Ignore transaction boundaries

Output Templates

When implementing Java features, provide:

Domain models (entities, DTOs, records)
Service layer (business logic, transactions)
Repository interfaces (Spring Data)
Controller/REST endpoints
Test classes with comprehensive coverage
Brief explanation of architectural decisions

Code Examples

Minimal WebFlux REST Endpoint

@RestController
@RequestMapping("/api/v1/orders")
@RequiredArgsConstructor
public class OrderController {

    private final OrderService orderService;

    @GetMapping("/{id}")
    public Mono<ResponseEntity<OrderDto>> getOrder(@PathVariable UUID id) {
        return orderService.findById(id)
                .map(ResponseEntity::ok)
                .defaultIfEmpty(ResponseEntity.notFound().build());
    }

    @PostMapping
    @ResponseStatus(HttpStatus.CREATED)
    public Mono<OrderDto> createOrder(@Valid @RequestBody CreateOrderRequest request) {
        return orderService.create(request);
    }
}

JPA Repository with Optimized Query

public interface OrderRepository extends JpaRepository<Order, UUID> {

    // Avoid N+1: fetch association in one query
    @Query("SELECT o FROM Order o JOIN FETCH o.items WHERE o.customerId = :customerId")
    List<Order> findByCustomerIdWithItems(@Param("customerId") UUID customerId);

    // Projection to limit fetched columns
    @Query("SELECT new com.example.dto.OrderSummary(o.id, o.status, o.total) FROM Order o WHERE o.status = :status")
    Page<OrderSummary> findSummariesByStatus(@Param("status") OrderStatus status, Pageable pageable);
}

Spring Security OAuth2 JWT Configuration

@Configuration
@EnableMethodSecurity
public class SecurityConfig {

    @Bean
    public SecurityFilterChain filterChain(HttpSecurity http) throws Exception {
        return http
                .csrf(AbstractHttpConfigurer::disable)
                .sessionManagement(s -> s.sessionCreationPolicy(STATELESS))
                .authorizeHttpRequests(auth -> auth
                        .requestMatchers("/actuator/health").permitAll()
                        .anyRequest().authenticated())
                .oauth2ResourceServer(oauth2 -> oauth2.jwt(Customizer.withDefaults()))
                .build();
    }
}

Knowledge Reference

Weekly Installs

1.6K

Repository

jeffallan/claude-skills

GitHub Stars

7.2K

First Seen

Jan 20, 2026

Security Audits

Gen Agent Trust HubPass SocketPass SnykPass

Installed on

opencode1.4K

gemini-cli1.3K

codex1.3K

github-copilot1.2K

cursor1.1K

claude-code1.1K

React 组合模式指南：Vercel 组件架构最佳实践，提升代码可维护性

102,200 周安装