Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
@@ -0,0 +1,72 @@
package com.shadowfit.global.config;

import lombok.extern.slf4j.Slf4j;
import org.springframework.beans.factory.InitializingBean;
import org.springframework.stereotype.Component;

import javax.sql.DataSource;
import java.sql.Connection;
import java.sql.ResultSet;
import java.sql.SQLException;
import java.sql.Statement;

/**
* 기동 시 binlog 형식을 확인한다 — {@code STATEMENT} 면 기동을 거부한다 (#276).
*
* <p><b>왜 필요한가.</b> pose 저장({@code PoseDataService.savePoseDataBatch})은 #276 처방으로
* READ COMMITTED 로 돈다. InnoDB 는 RC 트랜잭션의 쓰기를 STATEMENT 형식으로 binlog 에 적을 수 없어
* 그 쓰기를 오류로 거부한다(MySQL 오류 1665). 데이터가 조용히 깨지는 것이 아니라 <b>pose 저장이 전부
* 실패하는 장애</b>다. 그런데 지금 이 서비스는 binlog 형식을 어디에도 적지 않고 MySQL 8.0 기본값
* {@code ROW} 에 기대고 있다(compose·my.cnf 모두 지정 없음). 누가 서버 설정을 바꾸거나 DB 를
* 관리형으로 옮기며 파라미터가 달라지면, 그 장애는 운동 중인 사용자에게서 처음 드러난다.
* 이 검사는 그 시점을 <b>배포 순간</b>으로 당긴다.
*
* <p><b>판정</b> — {@code ROW}·{@code MIXED} 는 통과(MIXED 는 RC 에서 행 형식으로 바꿔 적는다),
* binlog 가 꺼져 있으면 형식과 무관하게 통과, {@code STATEMENT} 만 거부. 보는 값은 <b>세션</b> 값이다 —
* 실제 쓰기는 이 풀의 연결에서 일어나고, 세션 값은 연결 시점의 전역 값을 물려받는다.
*
* <p><b>MySQL 이 아니면 건너뛴다</b> — 기본 테스트는 H2 라 {@code @@binlog_format} 이 없다.
*
* <p>{@link InitializingBean} 인 이유: {@code ApplicationRunner} 는 gRPC 서버가 이미 요청을 받기
* 시작한 뒤에 돈다. 여기서 던지면 컨텍스트가 뜨기 전에 멈춘다.
*
* <p>분기와 근거: {@code docs/decisions/r276-lock-root-cause-fix.md} §2 ㄴ
*/
@Slf4j
@Component
public class BinlogFormatStartupCheck implements InitializingBean {

private final DataSource dataSource;

public BinlogFormatStartupCheck(DataSource dataSource) {
this.dataSource = dataSource;
}

@Override
public void afterPropertiesSet() throws SQLException {
try (Connection c = dataSource.getConnection()) {
String product = c.getMetaData().getDatabaseProductName();
if (!"MySQL".equalsIgnoreCase(product)) {
log.debug("binlog 형식 검사 건너뜀 — DB 가 MySQL 이 아니다: {}", product);
return;
}
try (Statement st = c.createStatement();
ResultSet rs = st.executeQuery("SELECT @@GLOBAL.log_bin, @@SESSION.binlog_format")) {
rs.next();
boolean logBin = rs.getInt(1) == 1;
String format = rs.getString(2);
check(logBin, format);
log.info("binlog 형식 확인 — log_bin={} binlog_format={} (RC 저장과 함께 쓸 수 있다)", logBin, format);
}
}
}

/** 판정만 따로 — 서버 설정을 바꾸지 않고 거부 경로를 시험할 수 있게. */
static void check(boolean logBin, String format) {
if (logBin && "STATEMENT".equalsIgnoreCase(format)) {
throw new IllegalStateException(
"binlog_format=STATEMENT 에서는 READ COMMITTED 로 도는 pose 저장이 전부 오류(1665)로 실패한다 (#276). "
+ "MySQL 을 binlog_format=ROW(또는 MIXED)로 띄울 것 — docs/decisions/r276-lock-root-cause-fix.md §2 ㄴ");
}
}
}
Original file line number Diff line number Diff line change
@@ -0,0 +1,77 @@
package com.shadowfit.global.config;

import com.shadowfit.support.MySqlContainerSupport;
import com.zaxxer.hikari.HikariDataSource;
import org.junit.jupiter.api.DisplayName;
import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.jdbc.core.JdbcTemplate;
import org.springframework.test.context.ActiveProfiles;

import javax.sql.DataSource;
import java.sql.Connection;
import java.sql.DriverManager;
import java.sql.SQLException;
import java.sql.Statement;

import static org.assertj.core.api.Assertions.assertThat;
import static org.assertj.core.api.Assertions.assertThatCode;
import static org.assertj.core.api.Assertions.catchThrowableOfType;

/**
* 실 MySQL 에서 — ① 검사가 기본 설정(8.0 기본값 ROW)을 통과시키는가, ② 검사가 막으려는 장애가
* 실제로 있는가(STATEMENT + RC 쓰기 = 오류 1665).
*
* <p>② 가 이 검사의 존재 이유다. 이 전제가 MySQL 버전에서 바뀌면(예: 거부 대신 조용히 다른 형식으로
* 적기) 검사는 쓸모없는 기동 거부가 되므로, 그때 이 테스트가 먼저 깨지게 둔다.
*/
@SpringBootTest
@ActiveProfiles("race")
@DisplayName("binlog 형식 기동 검사 (실 MySQL, #276)")
class BinlogFormatStartupCheckRaceTest extends MySqlContainerSupport {

@Autowired
BinlogFormatStartupCheck check;

@Autowired
DataSource dataSource;

@Autowired
JdbcTemplate jdbc;

@Test
@DisplayName("기본 설정의 MySQL 8.0 은 binlog 가 켜져 있고 ROW 라 검사를 통과한다")
void defaultServerPasses() {
assertThat(jdbc.queryForObject("SELECT @@GLOBAL.log_bin", Integer.class)).isEqualTo(1);
assertThat(jdbc.queryForObject("SELECT @@SESSION.binlog_format", String.class)).isEqualTo("ROW");
assertThatCode(check::afterPropertiesSet).doesNotThrowAnyException();
}

@Test
@DisplayName("전제: binlog_format=STATEMENT 에서 READ COMMITTED 쓰기는 오류 1665 로 거부된다")
void statementWithReadCommittedWriteFails() throws SQLException {
HikariDataSource hikari = (HikariDataSource) dataSource;
// binlog_format 을 세션에서 바꾸려면 SYSTEM_VARIABLES_ADMIN 이 필요해 root 로 붙는다.
// Testcontainers 의 MySQLContainer 는 root 암호를 앱 계정 암호와 같게 둔다.
try (Connection root = DriverManager.getConnection(hikari.getJdbcUrl(), "root", hikari.getPassword());
Statement st = root.createStatement()) {
st.execute("DROP TABLE IF EXISTS binlog_rc_probe");
st.execute("CREATE TABLE binlog_rc_probe (id INT PRIMARY KEY) ENGINE=InnoDB");
try {
st.execute("SET SESSION binlog_format = 'STATEMENT'");
st.execute("SET SESSION TRANSACTION ISOLATION LEVEL READ COMMITTED");
root.setAutoCommit(false);
SQLException e = catchThrowableOfType(
() -> st.executeUpdate("INSERT INTO binlog_rc_probe VALUES (1)"), SQLException.class);
assertThat((Throwable) e).as("STATEMENT + RC 쓰기가 거부되지 않았다 — 검사의 전제가 바뀌었다").isNotNull();
assertThat(e.getErrorCode()).isEqualTo(1665);
root.rollback();
} finally {
root.setAutoCommit(true);
st.execute("SET SESSION binlog_format = 'ROW'");
st.execute("DROP TABLE IF EXISTS binlog_rc_probe");
}
}
}
}
Original file line number Diff line number Diff line change
@@ -0,0 +1,35 @@
package com.shadowfit.global.config;

import org.junit.jupiter.api.DisplayName;
import org.junit.jupiter.api.Test;

import static org.assertj.core.api.Assertions.assertThatCode;
import static org.assertj.core.api.Assertions.assertThatThrownBy;

/** 판정 규칙만 — 실 MySQL 에서의 조회와 전제(오류 1665)는 {@link BinlogFormatStartupCheckRaceTest}. */
@DisplayName("binlog 형식 기동 검사 — 판정 (#276)")
class BinlogFormatStartupCheckTest {

@Test
@DisplayName("binlog 가 켜져 있고 STATEMENT 면 기동을 거부한다")
void statementIsRejected() {
assertThatThrownBy(() -> BinlogFormatStartupCheck.check(true, "STATEMENT"))
.isInstanceOf(IllegalStateException.class)
.hasMessageContaining("1665");
assertThatThrownBy(() -> BinlogFormatStartupCheck.check(true, "statement"))
.isInstanceOf(IllegalStateException.class);
}

@Test
@DisplayName("ROW·MIXED 는 통과한다")
void rowAndMixedPass() {
assertThatCode(() -> BinlogFormatStartupCheck.check(true, "ROW")).doesNotThrowAnyException();
assertThatCode(() -> BinlogFormatStartupCheck.check(true, "MIXED")).doesNotThrowAnyException();
}

@Test
@DisplayName("binlog 가 꺼져 있으면 형식과 무관하게 통과한다")
void binlogOffPasses() {
assertThatCode(() -> BinlogFormatStartupCheck.check(false, "STATEMENT")).doesNotThrowAnyException();
}
}
6 changes: 4 additions & 2 deletions docs/decisions/r276-lock-root-cause-fix.md
Original file line number Diff line number Diff line change
Expand Up @@ -42,8 +42,8 @@ RR 에서 **중복 키 한 건**이 `PRIMARY` 의 파티션 끝(supremum)에 `X`
|---|---|
| supremum `X` 가 사라진다 · 동시 부하 0/960 | **한 방향 대기는 남는다** — 재전송 트랜잭션이 커밋할 때까지 «다음 세션 원본 앞 gap» 에 들어갈 신규 삽입이 기다린다 |
| 코드 한 줄 · 되돌리기 쉽다 · 스키마 불변 | 「순환이 안 생긴다」는 **세션 키가 `session_id` 로 묶여 있다는 논증**이다. 한 트랜잭션이 여러 세션 키를 섞는 경로가 생기면 안 선다 |
| | 같은 트랜잭션 안의 세션 조회(`findById`)도 RC 가 된다 — 이 경로에선 무해해 보이나 **확인 안 함** |
| | binlog 는 8.0 기본값 ROW 에 기대고 있다(설정 파일에 명시 없음). STATEMENT 로 바뀌면 RC 와 못 산다 |
| | ~~같은 트랜잭션 안의 세션 조회(`findById`)도 RC 가 된다 — 확인 안 함~~ → ✅ **확인함(2026-11-08, 코드 대조) — 보장이 달라지지 않는다.** 트랜잭션 안의 문장은 넷이다: 세션 조회(잠금 없는 읽기 1회 — 한 번만 읽으면 RR·RC 가 같은 시점을 본다) · 종목 조회(`isCountOnly` 의 지연 로딩, 잠금 없는 읽기 — «점수 칸을 비울지» 만 정하고 앞 읽기와 맞을 필요가 없다) · pose `INSERT … ON DUPLICATE`(의도한 변화) · `UPDATE exercise_sessions … WHERE id=?`(PK 등호라 RR 에서도 갭 락이 없다). «세션이 `IN_PROGRESS` 면 저장» 검사는 RR 에서도 잠금 없는 읽기라 원래 경쟁을 막지 않았다 — 잃은 보장이 없다. 재시도는 트랜잭션 밖(`ExerciseGrpcService.savePoseDataBatchWithDeadlockRetry`)이라 RC 가 바깥 트랜잭션에 묻히지 않는다 |
| | binlog 는 8.0 기본값 ROW 에 기대고 있다(설정 파일에 명시 없음). STATEMENT 로 바뀌면 RC 쓰기가 **오류 1665 로 거부**된다 — 데이터가 조용히 깨지는 게 아니라 pose 저장이 전부 실패하는 장애다. → **기동 시 검사로 막는다(2026-11-08 사용자 confirm)**: `BinlogFormatStartupCheck` 가 `log_bin=ON` 이고 세션 `binlog_format=STATEMENT` 면 기동을 거부한다(ROW·MIXED·binlog 꺼짐은 통과). compose 에 `--binlog-format` 을 적는 안은 8.0.34+ 에서 deprecated 경고가 나고 compose 밖(관리형 DB)에선 효과가 없어 택하지 않았다. 전제(1665)는 `BinlogFormatStartupCheckRaceTest` 가 실 MySQL 에서 재현한다 |

### ㄷ. 멱등 키를 PK 로 — `(session_id, rep_number, timestamp_sec, created_at)`, id 는 AUTO_INCREMENT 보조 인덱스로 유지

Expand Down Expand Up @@ -141,3 +141,5 @@ RR 에서 **중복 키 한 건**이 `PRIMARY` 의 파티션 끝(supremum)에 `X`
박스·규모·범위(§5-5 네 건)는 confirm 대기
- 2026-11-08 — **§5-5 네 건 추천대로 확정 (사용자 confirm).** ① `c7i.xlarge` · ②③ `m6i.xlarge` · ② 1,000만 행 ·
③ 같이 · B′ 넣음. 다음은 rig 작성 → 로컬 축소 스모크 → EC2 무인 라운드
- 2026-11-08 — **ㄴ 의 «모르는 것» 두 줄 닫음.** `findById` 등 같은 트랜잭션의 다른 문장은 코드 대조로 «보장 불변» 확인.
binlog 형식은 **기동 시 검사로 막기로 함 (사용자 confirm)** — `BinlogFormatStartupCheck` · 테스트 2벌(판정 · 실 MySQL 전제 1665)
Loading