К основному содержанию
правило CX Codex

spring-performance · kyy-logs, code-review-gate-zh — правило для Claude Code: Spring/JPA

Правило spring-performance для Claude Code задаёт практики Spring/JPA и оптимизации производительности. Агент применяет их при работе с Java-кодом и запросами к базе данных.

MIT ★ 517 обновлён 2026-11-16

Установить в Claude Code · Вручную: положить файлы Все способы и платформы ↓
.claude/rules/spring-performance.md
Открыть на GitHub

Что делает spring-performance

Правило spring-performance задаёт рекомендации по валидации входных данных, транзакциям, обработке исключений и работе с запросами JPA. Для защиты от N+1 предлагаются JOIN FETCH или EntityGraph, а для повторяющихся вставок — пакетная операция.

В производительности правило затрагивает создание строк в циклах, системные настройки Linux и создание JVM HeapDump при OOM. Для Linux приведены рекомендации net.ipv4.tcp_fin_timeout=30 и ulimit -n 65535; значение 65535 относится к максимальному числу файловых дескрипторов.

Какие задачи решает

  • проверить валидацию параметров Spring-контроллера
  • найти транзакции с неподходящим охватом
  • заменить N+1-запросы на JOIN FETCH или EntityGraph
  • перевести одиночные вставки в цикле на пакетную операцию
  • сократить создание строк при сборке результата

Примеры запросов агенту

  • Проверь обработчик создания пользователя на соответствие правилу spring-performance.
  • Найди в этом репозитории запросы JPA с проблемой N+1.
  • Проверь цикл вставки пользователей и предложи пакетную операцию.

Как установить spring-performance

Вручную: положить файлы

.claude/rules/spring-performance.md

Поле paths во frontmatter ограничивает файлы

По шагам, с командами для каждой платформы: AGENTS.md и CLAUDE.md: что это, кто читает и какой выбрать

Вопросы о spring-performance

Как установить spring-performance в Claude Code?

Добавь правило в файл .claude/rules/spring-performance.md.

Что делает spring-performance?

Задаёт практики Spring/JPA для валидации, транзакций, обработки исключений и оптимизации запросов и операций.

Какие способы защиты от N+1 предлагает spring-performance?

Правило предлагает использовать JOIN FETCH или EntityGraph для загрузки связанных заказов вместе с пользователями.

Исходный текст

spring-performance.md · MIT
# Spring/JPA 与性能优化规范

## Spring/JPA 最佳实践

### 参数验证

```java
// 正确:使用@Valid验证
@PostMapping("/users")
public UserDTO createUser(@Valid @RequestBody UserCreateRequest request) {
    return userService.create(request);
}

@Data
public class UserCreateRequest {
    @NotBlank(message = "用户名不能为空")
    @Size(min = 2, max = 50, message = "用户名长度2-50")
    private String name;
    
    @Email(message = "邮箱格式不正确")
    private String email;
    
    @Min(value = 0, message = "年龄不能为负")
    private Integer age;
}
```

### 事务管理

```java
// 正确:事务范围明确
@Transactional(rollbackFor = Exception.class)
public void createUser(User user, UserProfile profile) {
    userDao.insert(user);
    profile.setUserId(user.getId());
    profileDao.insert(profile);
}

// 注意:只读操作不加事务或使用只读事务
@Transactional(readOnly = true)
public User getUser(Long id) {
    return userDao.findById(id);
}
```

### N+1查询防护

```java
// 错误:N+1查询
List<User> users = userDao.findAll();
for (User user : users) {
    List<Order> orders = orderDao.findByUserId(user.getId());  // N次查询!
    user.setOrders(orders);
}

// 正确:使用JOIN FETCH
@Query("SELECT u FROM User u LEFT JOIN FETCH u.orders WHERE u.id IN :ids")
List<User> findWithOrders(@Param("ids") List<Long> ids);

// 或使用EntityGraph
@Entity
@NamedEntityGraph(name = "User.withOrders", 
    attributeNodes = @NamedAttributeNode("orders"))
public class User { ... }
```

### 统一异常处理

```java
// 统一异常处理
@RestControllerAdvice
public class GlobalExceptionHandler {
    
    @ExceptionHandler(BusinessException.class)
    public ResponseEntity<ErrorResponse> handleBusiness(BusinessException e) {
        return ResponseEntity.badRequest()
            .body(new ErrorResponse(e.getCode(), e.getMessage()));
    }
    
    @ExceptionHandler(Exception.class)
    public ResponseEntity<ErrorResponse> handleOther(Exception e) {
        log.error("Unexpected error", e);
        return ResponseEntity.internalServerError()
            .body(new ErrorResponse("SYSTEM_ERROR", "系统错误"));
    }
}
```

## 性能优化规范

### 服务器配置

| 配置项 | 说明 | 推荐值 |
|-------|------|-------|
| TCP time_wait超时 | 高并发场景调小 | `net.ipv4.tcp_fin_timeout=30` |
| 最大文件句柄数 | Linux默认1024不够 | `ulimit -n 65535` |
| JVM HeapDump | OOM时生成堆转储 | `-XX:+HeapDumpOnOutOfMemoryError` |

### 对象创建

```java
// 错误:循环中创建字符串
String result = "";
for (String item : list) {
    result += item + ",";  // 每次创建新String!
}

// 正确:使用StringBuilder
StringBuilder sb = new StringBuilder();
for (String item : list) {
    if (sb.length() > 0) sb.append(",");
    sb.append(item);
}
String result = sb.toString();

// 或使用String.join
String result = String.join(",", list);
```

### 批量操作

```java
// 错误:循环单条插入
for (User user : users) {
    userDao.insert(user);  // N次IO!
}

// 正确:批量插入
userDao.batchInsert(users);
```

© kyy-logs · MIT · kyy-logs/code-review-gate-skill

Похожие правила IDE

Все правила IDE по теме «Бэкенд и API» →

Сначала — spring-performance от других авторов.

spring-performance kyy-logs Правило spring-performance для Claude Code задаёт проверки Spring/JPA и производительности. Оно помогает находить ошибки валидации, транзакциях, запросах и пакетной обработке. CX Codex +1 ★ 517звёзд репо java-spring-boot pluginagentmarketplace Скилл java-spring-boot помогает создавать бэкенд на Spring Boot 3: настраивать REST API, аутентификацию через Spring Security, доступ к базам через Spring Data и мониторинг Actuator. CX Codex +1 11 800установок spring-data-jpa giuseppe-trisciuoglio Скилл spring-data-jpa для Claude Code помогает создавать репозитории и настраивать связи сущностей. Он подключается к задачам с запросами, транзакциями, аудитом и пагинацией. CX Codex +1 4 300установок spring-boot-crud-patterns giuseppe-trisciuoglio Скилл spring-boot-crud-patterns собирает полный CRUD-слой для сервисов на Spring Boot 3: агрегаты, JPA-репозитории, DTO и REST-контроллеры по feature-архитектуре. CX Codex +1 4 100установок 311-frameworks-spring-jdbc Juan Antonio Breña Moral Скилл 311-frameworks-spring-jdbc для ревью и написания JDBC-кода на Spring: подсказывает JdbcClient, ловит SQL-инъекции и правит границы транзакций. CX Codex +1 352установок 312-frameworks-spring-data-jdbc Juan Antonio Breña Moral Скилл 312-frameworks-spring-data-jdbc для работы с Spring Data JDBC на Java records: сущности, репозитории, границы агрегатов, транзакции и борьба с N+1. CX Codex +1 349установок convert-jpa-to-spring-data-cosmos официальный github Правило convert-jpa-to-spring-data-cosmos для GitHub Copilot: переводит Spring Boot проект с JPA на Azure Cosmos DB через Spring Data Cosmos. Описывает девять шагов миграции — от замены зависимостей до переделки сущностей и тестов. CX Codex +1 ★ 41 430звёзд репо

Из того же набора10

Весь набор →
index Правило index для Claude Code описывает состав набора правил проверки кода и порядок их поиска. Проектный набор заменяет встроенный целиком, а не дополняет его. CX Codex +1 ★ 517звёзд репо baseline-java Правило baseline-java для Claude Code добавляет проверки безопасности, многопоточности и обработки исключений в Java. Агент применяет его при разборе Java-кода. CX Codex +1 ★ 517звёзд репо spring-performance Правило spring-performance для Claude Code задаёт проверки Spring/JPA и производительности. Оно помогает находить ошибки валидации, транзакциях, запросах и пакетной обработке. CX Codex +1 ★ 517звёзд репо concurrency Правило concurrency для Claude Code задаёт требования к многопоточности в Java-коде. Оно охватывает пулы потоков, блокировки, общие данные и другие источники ошибок конкурентного доступа. CX Codex +1 ★ 517звёзд репо exception-logging Правило exception-logging для Claude Code проверяет обработку исключений и логирование в коде на Java. Контролирует пустые блоки catch, вызовы SLF4J, маскирование данных и откат транзакций. CX Codex +1 ★ 517звёзд репо naming-format Правило naming-format для Claude Code задаёт соглашения об именах и форматировании Java-кода. Оно охватывает классы, методы, константы и управляющие конструкции. CX Codex +1 ★ 517звёзд репо testing-engineering Правило testing-engineering для Claude Code задаёт требования к юнит-тестам, архитектуре проекта и зависимостям. Оно охватывает проектирование слоёв, обработку исключений и соглашения для моделей данных. CX Codex +1 ★ 517звёзд репо code-review-gate Скилл code-review-gate для Claude Code проверяет изменения в коде перед коммитом или слиянием PR. Агент собирает diff, запускает проверки и фиксирует найденные проблемы. CX Codex +1 ★ 517звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой