파이썬 [Errno 28] No space left on device, 디스크가 남아도 확인할 순서

파이썬 [Errno 28] No space left on device는 디스크 전체가 비어 있는지보다 실패한 경로가 속한 파일시스템에 쓸 수 있는지가 먼저입니다. 실제 출력 경로와 임시 경로를 나누어 보고, 블록 공간과 inode를 구분한 뒤 정리·경로 변경·작업 중단 중 하나를 선택해야 합니다.

먼저 오류의 의미를 좁히기

Python 공식 errno 문서에서 ENOSPC는 장치에 공간이 없다는 시스템 오류 기호입니다. 여기서 장치는 컴퓨터 전체를 뜻한다고 단정할 수 없습니다. CSV를 저장한 경로와 임시 파일을 만든 경로가 서로 다른 마운트라면 한쪽은 여유가 있고 다른 쪽만 가득 찰 수 있습니다.

따라서 df -h 결과 한 줄만 보고 “공간이 남았다”고 결론 내리면 안 됩니다. 오류가 난 파일 또는 그 파일을 만들던 디렉터리의 경로를 먼저 확보하십시오.

확인 순서

실패한 출력 경로와 임시 경로를 분리합니다

예를 들어 자동화가 /data/result/run.csv를 쓰다가 멈췄다면 /data/result를 확인하고, 중간 처리에서 임시 파일을 만들었다면 임시 디렉터리도 별도로 확인합니다. 아래 경로와 뒤의 /approved/tmp는 가상의 예시이므로 실제 존재하고 승인된 작업 경로로 바꿔야 합니다. Python에서는 다음처럼 특정 경로가 속한 파일시스템의 사용량을 확인할 수 있습니다.

from shutil import disk_usage

for path in ("/data/result", "/tmp"):
    usage = disk_usage(path)
    print(path, {"total": usage.total, "used": usage.used, "free": usage.free})

shutil.disk_usage(path)는 지정한 파일 또는 디렉터리가 속한 파일시스템의 total, used, free 바이트를 반환합니다. Unix에서는 확인할 경로가 마운트된 파일시스템 파티션 안에 있어야 하므로, 실제 작업 경로를 넣는 것이 중요합니다.

셸에서 확인할 수 있는 환경이라면 다음처럼 동일한 경로를 지정해 비교합니다.

df -h /data/result
df -h /tmp
df -i /data/result
df -i /tmp

df -h와 df -i를 나눠 봅니다

df -h는 블록 기준 사용량을 보여 주고, df -i는 inode 정보를 보여 줍니다. Huawei Cloud의 Linux 사례에서는 사용 가능한 바이트가 남아 있어도 inode가 소진되면 파일이나 디렉터리를 만들 때 공간 부족 오류가 발생할 수 있습니다. 따라서 바이트 사용량과 inode 정보를 각각 확인해야 합니다.

판단은 간단히 나눌 수 있습니다.

  • df -h가 가득 찼다면 큰 출력 파일, 로그, 캐시, 임시 결과를 경로별로 확인합니다.
  • df -i가 가득 찼다면 작은 파일이 과도하게 쌓였는지와 파일 생성 루프를 확인합니다.
  • 둘 다 여유가 있다면 오류가 난 정확한 경로와 실행 환경을 다시 확인하고 운영 담당자에게 추가 점검을 요청합니다.

tempfile이 어느 경로를 쓰는지 확인합니다

tempfile은 임시 디렉터리를 찾을 때 TMPDIR, TEMP, TMP 순서로 환경 변수를 살핀 뒤 플랫폼별 기본 경로를 확인합니다. 코드가 출력 파일을 /data에 쓰더라도 중간 압축·변환·업로드 단계가 임시 디렉터리를 사용하면 /tmp가 실제 원인일 수 있습니다.

import os
import tempfile

print({name: os.environ.get(name) for name in ("TMPDIR", "TEMP", "TMP")})
print(tempfile.gettempdir())

gettempdir()가 가리키는 위치가 실패한 파일시스템과 같은지 확인하십시오. 임시 경로를 바꾸는 것은 그 경로에 쓰기 권한과 충분한 공간이 있고, 작업 보안·정리 정책이 허용될 때만 선택해야 합니다.

특정 작업에서만 임시 위치를 지정해야 한다면 tempfile 함수의 dir 인자를 사용할 수 있습니다.

from tempfile import TemporaryDirectory

with TemporaryDirectory(dir="/approved/tmp") as work_dir:
    print(work_dir)
    # work_dir 안에서 중간 파일을 처리합니다.

TemporaryDirectory는 컨텍스트가 끝나거나 객체가 소멸할 때 생성한 디렉터리와 내용을 제거하도록 동작합니다. 다만 작업이 중간에 실패했을 때도 보존해야 하는 진단 파일이라면 자동 정리 전에 별도 보존 위치로 복사하는 설계를 먼저 정해야 합니다.

정리할까, 경로를 바꿀까, 멈출까

정리는 원인과 소유자가 확인된 파일에만 적용합니다. 재생성 가능한 캐시나 오래된 결과라면 승인된 보존 기간과 삭제 절차를 확인한 뒤 정리할 수 있습니다. 입력 데이터, 유일한 모델 파일, 장애 분석에 필요한 로그를 “공간을 만들기 위해” 먼저 삭제하면 원인 파악과 복구가 더 어려워집니다.

임시 경로 변경은 작업이 실제로 임시 파일 때문에 실패했고, 승인된 다른 파일시스템을 사용할 수 있을 때의 선택입니다. 환경 변수를 바꿨다면 새 프로세스에서 tempfile.gettempdir()와 해당 경로의 df -h, df -i를 다시 확인해야 합니다.

다음과 같은 경우에는 작업을 멈추는 편이 안전합니다.

  • 어떤 파일시스템이 가득 찼는지 아직 모르는 경우
  • 삭제 대상이 입력·결과·로그 중 무엇인지 구분되지 않는 경우
  • 반복 생성이 계속되어 다시 공간을 채울 가능성이 있는 경우
  • 다른 서비스와 공간을 공유해 임의 정리가 장애를 만들 수 있는 경우

재발을 줄이는 운영 점검

자동화 시작 전에 결과 디렉터리와 임시 디렉터리의 파일시스템을 확인하고, 예상보다 큰 중간 산출물이 생기는 단계에는 보존 기간과 정리 책임을 정해 두는 것이 좋습니다. 파일을 반복 생성하는 작업은 파일 개수와 inode도 함께 관찰해야 합니다.

실행 중에는 예외 메시지만 저장하지 말고 실패한 파일 경로와 tempfile.gettempdir() 결과를 함께 남기면 다음 진단이 빨라집니다. 다만 로그 자체가 같은 디스크를 계속 채우지 않는지 확인해야 합니다.

핵심은 df -h 한 번의 결과가 아니라 “어느 경로에 쓰려 했는가”에서 시작하는 것입니다. 실제 출력 경로와 임시 경로를 각각 disk_usage() 또는 df로 확인하고, df -i로 inode를 분리해 본 뒤에야 정리나 임시 경로 변경을 선택할 수 있습니다.

확인한 자료

Leave a Comment