TIL

[H2 DB] μ™„μ „ μ‚­μ œ ν›„ μž¬μ„€μΉ˜ 방법(Spring Boot ν”„λ‘œμ νŠΈ ν•˜λ©΄μ„œ 생긴 문제)

dev슀카이 2025. 2. 4. 23:19

πŸ”₯ H2 λ°μ΄ν„°λ² μ΄μŠ€ μ™„μ „ μ‚­μ œ 방법

βœ… Uninstall.exe μ‹€ν–‰
βœ… 남은 파일 μ‚­μ œ (C:\Program Files\H2\, jpashop.mv.db λ“±)
βœ… ν™˜κ²½ λ³€μˆ˜μ—μ„œ H2 κ΄€λ ¨ 경둜 μ‚­μ œ
βœ… λ ˆμ§€μŠ€νŠΈλ¦¬ 정리 (Windows ν•œμ •)
βœ… PC μž¬λΆ€νŒ… ν›„ H2 μ΅œμ‹  버전 λ‹€μš΄λ‘œλ“œ & μž¬μ„€μΉ˜
βœ… http://localhost:8082 μ ‘μ†ν•˜μ—¬ 정상 μž‘λ™ 확인


1️⃣ H2 제거 (Uninstall.exe μ‹€ν–‰)

  1. C:\Program Files\H2\ λ˜λŠ” C:\H2\둜 이동
  2. Uninstall.exe μ‹€ν–‰
  3. μ‚­μ œκ°€ μ™„λ£Œλ˜λ©΄ PCλ₯Ό μž¬λΆ€νŒ… (ν•„μˆ˜λŠ” μ•„λ‹˜)

β€» Program Files에 μ—†μœΌλ©΄ Program Files(x86) ν΄λ”μ—μ„œ 찾아보면 λœλ‹€. 

β€» λ‚˜λŠ” Unistall ν›„ H2 폴더λ₯Ό μ‚­μ œν•˜λ €κ³  ν•˜λŠ”λ° μ•ˆ λΌμ„œ μž¬λΆ€νŒ…μ„ ν–ˆλ‹€. κ·Έλž¬λ”λ‹ˆ μ‚­μ œκ°€ 됐닀. ν•„μˆ˜λŠ” μ•„λ‹ˆλ”λΌλ„ μž¬λΆ€νŒ…μ„ ν•΄μ£ΌλŠ” 편이 쒋을 것 κ°™λ‹€.


2️⃣ 남은 H2 파일 μˆ˜λ™ μ‚­μ œ

Uninstall.exeκ°€ λͺ¨λ“  νŒŒμΌμ„ μ‚­μ œν•˜μ§€ μ•Šμ„ μˆ˜λ„ μžˆλ‹€. λ‹€μŒ κ²½λ‘œμ— 남아 μžˆλŠ” 파일이 μžˆλŠ”μ§€ ν™•μΈν•˜κ³  직접 μ‚­μ œν•œλ‹€.

 

πŸ“Œ Windows

  • C:\Program Files\H2\ (κΈ°λ³Έ μ„€μΉ˜ 폴더)
  • C:\Users\your-username\h2\ (μ„€μ • 파일)
  • C:\Users\your-username\jpashop.mv.db (H2 데이터 파일)
  • C:\Users\your-username\.h2.server.properties (H2 μ„€μ • 파일)

πŸ“Œ Mac/Linux

  • /usr/local/h2/
  • ~/.h2.server.properties
  • ~/jpashop.mv.db (H2 데이터 파일)

πŸ‘‰ μœ„ 폴더λ₯Ό μ°Ύμ•„ μ‚­μ œν•˜κ³ , νœ΄μ§€ν†΅λ„ λΉ„μ›Œμ£Όμ„Έμš”!


3️⃣ Maven/Gradle μ˜μ‘΄μ„± μ‚­μ œ (Spring Boot ν”„λ‘œμ νŠΈμ—μ„œ H2 제거)

λ§Œμ•½ Spring Boot ν”„λ‘œμ νŠΈμ—μ„œ H2λ₯Ό μ‚¬μš©ν–ˆλ‹€λ©΄, ν”„λ‘œμ νŠΈμ—μ„œ H2 μ˜μ‘΄μ„±λ„ μ œκ±°ν•΄μ•Ό ν•œλ‹€.

 

βœ… Gradle (build.gradle)

gradle

 
dependencies {
    // μ•„λž˜ 쀄 μ‚­μ œ
    // implementation 'com.h2database:h2'
}

 

그리고 μ˜μ‘΄μ„± μΊμ‹œ μ‚­μ œ

sh
 
./gradlew clean

 

βœ… Maven (pom.xml)

xml
 
<dependency>
    <groupId>com.h2database</groupId>
    <artifactId>h2</artifactId>
</dependency>

 

μœ„ μ˜μ‘΄μ„± 제거 ν›„

sh
 
mvn clean

4️⃣ ν™˜κ²½ λ³€μˆ˜ 확인 및 μ‚­μ œ (ν•„μš”ν•œ 경우)

H2λ₯Ό 직접 μ„€μΉ˜ν•œ 경우, ν™˜κ²½ λ³€μˆ˜μ— λ“±λ‘λ˜μ—ˆμ„ μˆ˜λ„ μžˆλ‹€.

 

πŸ”Ή Windowsμ—μ„œ ν™˜κ²½ λ³€μˆ˜ μ‚­μ œ 방법

  1. Win + R → sysdm.cpl μž…λ ₯ ν›„ Enter
  2. κ³ κΈ‰ νƒ­ → "ν™˜κ²½ λ³€μˆ˜" 클릭
  3. Pathμ—μ„œ H2 κ΄€λ ¨ 경둜 (C:\Program Files\H2\bin λ“±) μ‚­μ œ
  4. 적용 ν›„ PC μž¬λΆ€νŒ…

πŸ”Ή Mac/Linuxμ—μ„œ ν™˜κ²½ λ³€μˆ˜ μ‚­μ œ
ν„°λ―Έλ„μ—μ„œ μ‹€ν–‰(sh)

 
nano ~/.bashrc  # λ˜λŠ” ~/.zshrc, ~/.bash_profile

 

그리고 export H2_HOME=... κ΄€λ ¨ 쀄 μ‚­μ œ ν›„ μ €μž₯.


5️⃣ λ ˆμ§€μŠ€νŠΈλ¦¬ 정리 (Windows)

H2λ₯Ό μ™„μ „νžˆ μ‚­μ œν–ˆμ§€λ§Œ, λ ˆμ§€μŠ€νŠΈλ¦¬μ— 남아 μžˆμ„ μˆ˜λ„ μžˆλ‹€.

  1. Win + R → regedit μž…λ ₯ ν›„ Enter
  2. Ctrl + F λ₯Ό 눌러 H2 λ˜λŠ” h2database 검색
  3. κ΄€λ ¨λœ ν‚€λ₯Ό μ‚­μ œ (H2 Database κ΄€λ ¨ ν•­λͺ©λ§Œ μ‚­μ œ 주의!)

πŸ”₯ H2 λ°μ΄ν„°λ² μ΄μŠ€ μž¬μ„€μΉ˜

πŸ”— https://www.h2database.com/html/main.html

 

H2 Database Engine

H2 Database Engine Welcome to H2, the Java SQL database. The main features of H2 are: Very fast, open source, JDBC API Embedded and server modes; in-memory databases Browser based Console application Small footprint: around 2.5 MB jar file size     Supp

www.h2database.com

 

μœ„ 링크에 λ“€μ–΄κ°€μ„œ 버전에 맞게 μž¬μ„€μΉ˜ν•˜λ©΄ λœλ‹€.