[Docker] macOS에서 MySQL 컨테이너 실행 오류 해결하기 – No space left on device (Error 28)

Docker를 이용해 MySQL 8.4 컨테이너를 실행하던 중 MySQL 서버가 정상적으로 시작되지 않는 문제가 발생했다.

로그를 확인해 보니 InnoDB 초기화 과정에서 No space left on device 오류가 발생하고 있었다.

이번 글에서는 macOS Docker Desktop 환경에서 발생한 MySQL 디스크 공간 부족 오류의 원인과 해결 방법을 정리한다.

1. 문제 상황

개발 환경은 다음과 같다.

• 운영체제: macOS
• 컨테이너 환경: Docker Desktop
• 데이터베이스: MySQL 8.4.11
• 실행 방식: Docker Compose

MySQL 컨테이너 실행 후 로그를 확인하니 다음과 같은 오류가 출력되었다.

[System] MySQL Server - start.
[System] /usr/sbin/mysqld (mysqld 8.4.11) starting as process 1
[System] [InnoDB] InnoDB initialization has started.

[Warning] [InnoDB] Retry attempts for writing partial data failed.

[ERROR] [InnoDB]
Write to file ./#innodb_redo/#ib_redo16_tmp failed
at offset 1048576, 1048576 bytes should have been written,
only 0 were written.

Operating system error number 28.

[ERROR] [InnoDB]
Error number 28 means 'No space left on device'

[ERROR] [InnoDB]
Cannot resize redo log file ./#innodb_redo/#ib_redo16_tmp
to 3 MB (Failed to set size)

가장 중요한 오류 메시지는 다음과 같다.

Error number 28 means 'No space left on device'

즉, MySQL이 데이터를 기록하려 했지만 저장 공간이 부족해 파일을 생성하거나 확장하지 못했다는 의미다.

2. 오류 원인 분석

InnoDB Redo Log란?

MySQL의 기본 스토리지 엔진인 InnoDB는 데이터의 안정성과 트랜잭션 복구를 위해 Redo Log를 사용한다.

Redo Log는 데이터 변경 사항을 기록해 두었다가 장애 발생 시 복구에 활용하는 로그다.

MySQL 8.4에서는 일반적으로 다음 경로에 Redo Log 파일이 생성된다.

/var/lib/mysql/#innodb_redo/

이번 오류에서는 다음 파일에 데이터를 기록하지 못했다.

./#innodb_redo/#ib_redo16_tmp

MySQL이 Redo Log 파일을 확장하는 과정에서 운영체제로부터 오류 번호 28을 반환받은 것이다.

macOS에서 발생하는 이유

macOS의 Docker Desktop은 Linux 컨테이너를 실행하기 위해 Linux 가상 머신을 사용한다.

따라서 Docker가 사용하는 저장 공간과 macOS 호스트의 저장 공간은 관리 방식이 다르다.

대표적인 원인은 다음과 같다.

1. macOS 호스트 디스크의 여유 공간 부족
2. Docker Desktop 가상 디스크의 용량 제한 도달
3. 사용하지 않는 Docker 이미지와 컨테이너의 누적
4. Docker 빌드 캐시의 과도한 증가
5. MySQL 데이터 볼륨이 위치한 파일 시스템의 공간 부족

특히 macOS에 디스크 여유 공간이 남아 있더라도 Docker Desktop 내부 저장 공간이 부족하면 동일한 오류가 발생할 수 있다.

3. Docker 디스크 사용량 확인

가장 먼저 Docker가 얼마나 많은 디스크 공간을 사용하고 있는지 확인한다.

docker system df

이 명령어는 Docker 이미지, 컨테이너, 볼륨, 빌드 캐시의 사용량을 보여준다.

출력 예시는 다음과 같다.

TYPE            TOTAL   ACTIVE   SIZE      RECLAIMABLE
Images          25      8        12.5GB    8.2GB
Containers      12      3        1.2GB     800MB
Local Volumes   15      5        18.4GB    4.5GB
Build Cache     120     0        9.8GB     9.8GB

위 수치는 설명을 위한 예시이며 실제 환경에 따라 다르다.

여기서 주목할 항목은 RECLAIMABLE이다.

이는 Docker가 미사용 리소스로 판단해 정리할 수 있는 용량을 의미한다.

더 상세한 정보를 확인하려면 다음 명령어를 실행한다.

docker system df -v

macOS 호스트의 디스크 공간도 함께 확인한다.

df -h

4. Docker 디스크 공간 정리하기

원인을 확인한 후 불필요한 Docker 리소스를 정리한다.

4.1 중지된 컨테이너 삭제

docker container prune

현재 실행 중이지 않은 컨테이너를 삭제한다.

4.2 사용하지 않는 이미지 삭제

docker image prune -a

실행 중이거나 중지된 컨테이너에서 참조하지 않는 이미지를 삭제한다.

삭제된 이미지는 이후 필요할 때 다시 다운로드하거나 빌드해야 한다.

4.3 Docker 빌드 캐시 정리

docker builder prune

사용하지 않는 빌드 캐시를 삭제한다.

개발 과정에서 Docker 이미지를 반복적으로 빌드하면 캐시가 상당한 용량을 차지할 수 있다.

4.4 미사용 리소스 일괄 정리

위 작업을 한 번에 실행하려면 다음 명령어를 사용할 수 있다.

docker system prune -a

이 명령어는 중지된 컨테이너, 사용하지 않는 네트워크와 이미지, 미사용 빌드 캐시 등을 정리한다.

주의할 점은 데이터베이스 볼륨이다.

다음 명령어들은 데이터 손실 가능성이 있으므로 신중하게 사용해야 한다.

docker volume prune
docker system prune --volumes
docker compose down -v

특히 docker compose down -v는 Compose 프로젝트에서 사용하는 named volume까지 삭제할 수 있다.

MySQL 데이터를 유지해야 한다면 볼륨 삭제 명령어를 실행하지 않는 것이 안전하다.

5. Docker Desktop 디스크 용량 확인

Docker 리소스를 정리했는데도 문제가 해결되지 않는다면 Docker Desktop의 디스크 용량 제한을 확인한다.

macOS에서 Docker Desktop을 실행한 뒤 다음 메뉴로 이동한다.

Docker Desktop → Settings → Resources → Advanced

Docker Desktop 버전에 따라 설정 화면이나 항목 이름이 다를 수 있지만, 디스크 사용량 및 용량 제한 관련 설정을 확인할 수 있다.

설정된 디스크 용량이 부족하다면 여유 공간과 호스트 디스크 용량을 고려해 제한을 늘린다.

단, 디스크 이미지를 삭제하거나 초기화하는 기능은 기존 Docker 데이터가 손실될 수 있으므로 주의해야 한다.

6. MySQL 컨테이너 다시 실행

디스크 공간을 확보했다면 MySQL 컨테이너를 다시 실행한다.

docker compose up -d mysql

실행 상태를 확인한다.

docker compose ps

로그도 확인한다.

docker compose logs -f mysql

MySQL이 정상적으로 초기화를 완료하고 연결을 받을 준비가 되었다면 다음과 유사한 메시지가 출력된다.

[System] [Server] /usr/sbin/mysqld: ready for connections.

이 메시지가 확인되면 MySQL 서버가 정상적으로 시작된 것이다.

단, Compose 서비스 이름이 mysql이 아니라면 실제 서비스 이름으로 변경해야 한다.

7. 추가 해결 방법: InnoDB Redo Log 크기 조정

디스크 공간이 충분한데도 Redo Log 관련 문제가 반복된다면 MySQL의 Redo Log 설정을 검토할 수 있다.

MySQL 8.4에서는 innodb_redo_log_capacity 옵션으로 Redo Log 전체 용량을 설정할 수 있다.

예를 들어 개발 환경에서 64MB로 설정하려면 Docker Compose에 다음과 같이 작성한다.

services:
  mysql:
    image: mysql:8.4
    command:
      - --innodb-redo-log-capacity=64M
    environment:
      MYSQL_ROOT_PASSWORD: ${MYSQL_ROOT_PASSWORD}
      MYSQL_DATABASE: marketing_manager
    volumes:
      - mysql_data:/var/lib/mysql

volumes:
  mysql_data:

다만 Redo Log 용량을 지나치게 줄이면 체크포인트 작업이 빈번해져 데이터베이스 쓰기 성능에 영향을 줄 수 있다.

따라서 이 방법은 개발 환경이나 제한된 저장 공간에서 신중하게 검토할 수 있는 보조적인 방법이다.

디스크 공간이 부족한 상황이라면 Redo Log 크기를 조정하기보다 먼저 저장 공간을 확보하는 것이 우선이다.

8. Docker 디스크 부족 문제 예방하기

Docker를 장기간 사용하면 이미지와 빌드 캐시가 계속 누적될 수 있다.

따라서 개발 환경에서는 주기적으로 사용량을 확인하는 것이 좋다.

# Docker 디스크 사용량 확인
docker system df

# 사용하지 않는 빌드 캐시 정리
docker builder prune

# 중지된 컨테이너 정리
docker container prune

# 미사용 이미지 정리
docker image prune

또한 MySQL 같은 데이터베이스는 컨테이너를 삭제하더라도 데이터가 유지되도록 named volume을 사용하는 것이 좋다.

services:
  mysql:
    image: mysql:8.4
    volumes:
      - mysql_data:/var/lib/mysql

volumes:
  mysql_data:

단, named volume은 데이터의 영속성을 제공할 뿐 백업을 대체하지는 않는다. 중요한 데이터는 별도의 백업이 필요하다.

9. 마무리

이번 MySQL 컨테이너 실행 오류는 InnoDB 자체의 문제가 아니라 데이터를 기록할 저장 공간이 부족해 발생한 문제였다.

핵심 오류 메시지는 다음과 같다.

Operating system error number 28
No space left on device

이런 오류가 발생하면 MySQL 설정을 변경하거나 컨테이너를 삭제하기 전에 다음 순서로 확인하는 것이 좋다.

1. docker system df로 Docker 디스크 사용량 확인
2. df -h로 macOS 호스트 디스크 공간 확인
3. 불필요한 이미지, 컨테이너, 빌드 캐시 정리
4. Docker Desktop 디스크 용량 제한 확인
5. MySQL 컨테이너 재시작 및 로그 확인

특히 Docker를 이용해 여러 프로젝트를 개발하는 환경이라면 빌드 캐시와 오래된 이미지가 예상보다 많은 디스크 공간을 차지할 수 있다.

무엇보다 중요한 것은 MySQL 데이터 볼륨을 무작정 삭제하지 않는 것이다.

저장 공간 부족 문제는 대부분 불필요한 Docker 리소스를 정리하거나 Docker Desktop의 저장 공간 설정을 조정하는 방식으로 해결할 수 있다.

---