JSCODE Logo
JSCODE 박재성JSCODE 제이온JSCODE 시니
과외유튜브블로그후기
완강 후기 이벤트블로그 리뷰 이벤트AWS SAA 합격 후기 이벤트
회사명 : JSCODE대표 : 박재성사업자 등록번호 : 244-22-01557통신판매업 : 제 2023-인천미추홀-0381 호

서울특별시 구로구 경인로 20가길 11(오류동, 아델리아)

Copyright ⓒ 2026 JSCODE - 최상위 현업 개발자들의 프로그래밍 교육 All rights reserved.

이용약관개인정보처리방침

비전공자도 이해할 수 있는 Docker 입문

Docker 기본 개념

Docker를 왜 배우는 걸까?
Docker란 ? / 컨테이너(Container)란? / 이미지(Image)란?
Docker 설치 (Windows, Mac OS)
[실습] Docker 전체 흐름 느껴보기 (Nginx 설치 및 실행)

현업에서 자주 사용하는 Docker CLI 익히기

Docker 이미지(Image) 다운로드
Docker 이미지(Image) 조회 / 삭제
Docker 컨테이너(Container) 생성 / 실행 - 1
Docker 컨테이너(Container) 생성 / 실행 - 2
Docker 컨테이너(Container) 조회 / 중지 / 삭제
Docker 컨테이너(Container) 로그 조회
Docker 실행중인 컨테이너 내부에 접속하기 (exec -it)
[실습] Docker로 Redis 실행시켜보기

도커 볼륨을 활용해 데이터 유실 방지하기

Docker Volume(도커 볼륨)
[보충 자료] Windows에서 lsof, kill, sudo 명령어가 작동하지 않을 때 대처 방법
[실습] Docker로 MySQL 실행시켜보기 - 1
[실습] Docker로 MySQL 실행시켜보기 - 2
[실습] Docker로 MySQL 실행시켜보기 - 3
[실습] Docker로 PostgreSQL 실행시켜보기
[실습] Docker로 MongoDB 실행시켜보기

Dockerfile 활용해 이미지 직접 만들기

Dockerfile이란?
FROM : 베이스 이미지 생성
[실습] FROM : 베이스 이미지 생성
종료된 컨테이너에 들어가서 디버깅하고 싶을 때
COPY : 파일 복사(이동)
ENTRYPOINT : 컨테이너가 시작할 때 실행되는 명령어
[실습] 백엔드 프로젝트(Spring Boot) 프로젝트를 Docker로 실행시키기
RUN : 이미지를 생성하는 과정에서 사용할 명령문 실행
WORKDIR : 작업 디렉토리를 지정
EXPOSE : 컨테이너 내부에서 사용 중인 포트를 문서화하기
[실습] 백엔드 프로젝트(Nest.js)를 Docker로 실행시키기
[실습] 웹 프론트엔드 프로젝트(Next.js)를 Docker로 배포하기
[실습] 웹 프론트엔드 프로젝트(HTML, CSS, Nginx)를 Docker로 배포하기

Docker Compose를 활용해 컨테이너 관리하기

Docker Compose를 사용하는 이유
[실습] Docker Compose 전체 흐름 느껴보기 (Nginx 설치 및 실행)
자주 사용하는 Docker Compose CLI 명령어
[실습] Docker Compose로 Redis 실행시키기
[실습] Docker Compose로 MySQL 실행시키기
[실습] Docker Compose로 백엔드(Spring Boot) 실행시키기
[실습] Docker Compose로 백엔드(Nest.js) 실행시키기
[실습] Docker Compose로 프론트엔드(Next.js) 실행시키기
[실습] Docker Compose로 프론트엔드(HTML, CSS, Nginx) 실행시키기
Docker CLI ↔ Docker Compose 쉽게 작성하기

Docker Compose를 활용해 2개 이상의 컨테이너 관리하기

[실습] MySQL, Redis 컨테이너 동시에 띄워보기
[실습] Spring Boot, MySQL 컨테이너 동시에 띄워보기
컨테이너로 실행시킨 Spring Boot가 MySQL에 연결이 안 되는 이유
[실습] Spring Boot, MySQL, Redis 컨테이너 동시에 띄워보기

AWS EC2에서 Docker를 활용해 배포해보기

Ubuntu에서 Docker, Docker Compose 설치하기
AWS ECR(Elastic Container Registry)이 뭘까? 왜 배울까?
[실습] AWS ECR(Elastic Container Registry) 사용해보기
[실습] AWS EC2에 Docker + Spring Boot 배포하기
[실습] AWS EC2에 Docker + Spring Boot, MySQL, Redis 배포하기
← 블로그 목록으로 돌아가기

컨테이너로 실행시킨 Spring Boot가 MySQL에 연결이 안 되는 이유

JSCODE 박재성
JSCODE 박재성
2026. 03. 22.
author
JSCODE 박재성
category
Docker
createdAt
Dec 1, 2025 09:46 AM
isPublic
isPublic
series
비전공자도 이해할 수 있는 Docker 입문
slug
why-not-connecting-mysql-to-spring-boot
type
post
updatedAt
Mar 22, 2026 09:00

✅ 컨테이너로 실행시킨 Spring Boot가 MySQL에 연결이 안 되는 이유

notion image
각각의 컨테이너는 자신만의 네트워크망과 IP 주소를 가지고 있다. 호스트 컴퓨터 입장에서 localhost는 호스트 컴퓨터를 가리키지만, Spring Boot 컨테이너 입장에서 localhost는 Spring Boot 컨테이너를 가리킨다.
 
 
그런데 Spring Boot의 코드를 작성할 때 DB 정보를 아래와 같이 입력했었다. Spring Boot가 실행되는 환경인 컨테이너 입장에서 localhost:3306라는 주소는, Spring Boot 컨테이너 내부에 있는 3306번 포트와 연결을 시도하게 된다. 하지만 Spirng Boot가 실행되는 컨테이너 내부의 3306번 포트에는 아무것도 실행되고 있지 않다. 이러한 구조상의 문제 때문에 Spring Boot가 MySQL에 연결이 안 되고 있었던 것이다.
application.yml
spring: datasource: url: jdbc:mysql://localhost:3306/mydb username: root password: pwd1234 driver-class-name: com.mysql.cj.jdbc.Driver
 
 
그럼 어떻게 Spring Boot의 컨테이너에서 다른 컨테이너에 존재하는 MySQL에 연결을 할 수 있을까?
compose.yml에서 정의한 Service 이름으로 서로 통신할 수 있다. 바로 예시로 알아보자.
 
 

✅ Spring Boot의 DB 정보를 아래와 같이 수정한 뒤 시도해보기

application.yml
spring: datasource: url: jdbc:mysql://my-db:3306/mydb username: root password: pwd1234 driver-class-name: com.mysql.cj.jdbc.Driver
위 코드에서 my-db는 도대체 어디서 나온 값일까?
 
 
우리가 이전에 작성했던 compose.yml을 보면 각 컨테이너에 service 이름(my-server, my-db)을 작성했었다.
compose.yml
services: my-server: build: . ports: - 8080:8080 depends_on: my-db: condition: service_healthy my-db: image: mysql environment: MYSQL_ROOT_PASSWORD: pwd1234 MYSQL_DATABASE: mydb volumes: - ./mysql_data:/var/lib/mysql ports: - 3306:3306 healthcheck: test: [ "CMD", "mysqladmin", "ping" ] interval: 5s retries: 10
이 service 이름이 컨테이너의 주소를 뜻한다. 해당 컨테이너의 IP 주소와 같은 역할을 한다.
 
 
위와 같이 코드를 수정한 뒤에 다시 한 번 컨테이너를 실행시켜보자.
$ ./gradlew clean build $ docker compose down $ docker compose up --build -d $ docker ps # 정상적으로 Spring Boot, MySQL이 실행된 걸 확인할 수 있다.
 
📎
이 글은 비전공자도 이해할 수 있는 Docker 입문/실전 강의의 수업 자료 중 일부입니다.