diff --git a/backend/src/main/java/com/shadowfit/global/config/BinlogFormatStartupCheck.java b/backend/src/main/java/com/shadowfit/global/config/BinlogFormatStartupCheck.java new file mode 100644 index 00000000..d92a0451 --- /dev/null +++ b/backend/src/main/java/com/shadowfit/global/config/BinlogFormatStartupCheck.java @@ -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). + * + *
왜 필요한가. pose 저장({@code PoseDataService.savePoseDataBatch})은 #276 처방으로 + * READ COMMITTED 로 돈다. InnoDB 는 RC 트랜잭션의 쓰기를 STATEMENT 형식으로 binlog 에 적을 수 없어 + * 그 쓰기를 오류로 거부한다(MySQL 오류 1665). 데이터가 조용히 깨지는 것이 아니라 pose 저장이 전부 + * 실패하는 장애다. 그런데 지금 이 서비스는 binlog 형식을 어디에도 적지 않고 MySQL 8.0 기본값 + * {@code ROW} 에 기대고 있다(compose·my.cnf 모두 지정 없음). 누가 서버 설정을 바꾸거나 DB 를 + * 관리형으로 옮기며 파라미터가 달라지면, 그 장애는 운동 중인 사용자에게서 처음 드러난다. + * 이 검사는 그 시점을 배포 순간으로 당긴다. + * + *
판정 — {@code ROW}·{@code MIXED} 는 통과(MIXED 는 RC 에서 행 형식으로 바꿔 적는다), + * binlog 가 꺼져 있으면 형식과 무관하게 통과, {@code STATEMENT} 만 거부. 보는 값은 세션 값이다 — + * 실제 쓰기는 이 풀의 연결에서 일어나고, 세션 값은 연결 시점의 전역 값을 물려받는다. + * + *
MySQL 이 아니면 건너뛴다 — 기본 테스트는 H2 라 {@code @@binlog_format} 이 없다. + * + *
{@link InitializingBean} 인 이유: {@code ApplicationRunner} 는 gRPC 서버가 이미 요청을 받기 + * 시작한 뒤에 돈다. 여기서 던지면 컨텍스트가 뜨기 전에 멈춘다. + * + *
분기와 근거: {@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 ㄴ"); + } + } +} diff --git a/backend/src/test/java/com/shadowfit/global/config/BinlogFormatStartupCheckRaceTest.java b/backend/src/test/java/com/shadowfit/global/config/BinlogFormatStartupCheckRaceTest.java new file mode 100644 index 00000000..3ced0142 --- /dev/null +++ b/backend/src/test/java/com/shadowfit/global/config/BinlogFormatStartupCheckRaceTest.java @@ -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). + * + *
② 가 이 검사의 존재 이유다. 이 전제가 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"); + } + } + } +} diff --git a/backend/src/test/java/com/shadowfit/global/config/BinlogFormatStartupCheckTest.java b/backend/src/test/java/com/shadowfit/global/config/BinlogFormatStartupCheckTest.java new file mode 100644 index 00000000..59d83f28 --- /dev/null +++ b/backend/src/test/java/com/shadowfit/global/config/BinlogFormatStartupCheckTest.java @@ -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(); + } +} diff --git a/docs/decisions/r276-lock-root-cause-fix.md b/docs/decisions/r276-lock-root-cause-fix.md index bf450b78..a4f3d5ac 100644 --- a/docs/decisions/r276-lock-root-cause-fix.md +++ b/docs/decisions/r276-lock-root-cause-fix.md @@ -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 보조 인덱스로 유지 @@ -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)