백엔드 · 체크리스트

그누보드 파일 업로드 실패 점검표

그누보드·영카트에서 첨부파일이 저장되지 않을 때 게시판 설정, PHP 제한, 권한, 디스크를 분리해 확인하는 점검표입니다.

시작 전 확인

게시판 설정에서 첨부파일 기능과 파일 개수·크기 제한이 활성화되어 있는지 확인합니다.

브라우저 Network에서 업로드 요청의 상태 코드와 응답 본문을 기록합니다.

PHP의 `$_FILES[...][error]` 값과 `upload_max_filesize`, `post_max_size`를 같은 시점에 확인합니다.

PHP 임시 디렉터리와 그누보드 데이터 디렉터리가 존재하고 웹서버 실행 계정이 쓸 수 있는지 확인합니다.

파일 확장자·MIME 제한과 웹서버의 요청 본문 제한이 PHP보다 먼저 요청을 거부하지 않는지 확인합니다.

디스크 사용량과 inode 부족 여부를 확인하고, 수정 후 같은 파일·같은 게시판에서 다시 업로드합니다.

변경 전 확인

파일이 업로드되지 않을 때는 용량부터 늘리지 말고, 게시판 설정 → 요청 응답 → PHP 오류 코드 → 임시 경로 → 최종 저장 경로 순서로 확인합니다.

관찰값	우선 확인할 곳	흔히 혼동하는 원인
업로드 버튼을 눌러도 요청이 없음	브라우저 코드·게시판 설정	PHP 용량 제한으로 단정하지 않음
4xx 또는 요청 크기 초과	웹서버·프록시 요청 제한	`upload_max_filesize`만 올리지 않음
`UPLOAD_ERR_INI_SIZE`·`UPLOAD_ERR_FORM_SIZE`	PHP 설정과 HTML form 제한	저장 경로 권한과 구분
임시 파일 오류	PHP 임시 디렉터리	최종 업로드 디렉터리와 구분
요청은 성공하지만 파일이 없음	그누보드 저장 경로 권한·디스크	브라우저 표시 문제와 구분

게시판 URL:
파일 크기·확장자:
업로드 요청 상태 코드:
$_FILES error 값:
upload_max_filesize / post_max_size:
임시 경로·최종 경로:
웹서버 실행 계정·디스크 상태:

게시판 URL:파일 크기·확장자:업로드 요청 상태 코드:$_FILES error 값:upload_max_filesize / post_max_size:임시 경로·최종 경로:웹서버 실행 계정·디스크 상태:

수정 후에는 같은 파일을 같은 게시판에 다시 올리고, 게시글 목록·본문·저장 디렉터리를 모두 확인합니다.

SIR · 공식 자료 · 확인 범위: 그누보드 게시판 설정과 첨부 기능 확인 범위 · 확인일: 2026-08-03

The PHP Group · 공식 자료 · 확인 범위: PHP 업로드 오류 코드 · 확인일: 2026-08-03

The PHP Group · 공식 자료 · 확인 범위: PHP 업로드 크기와 요청 제한 설정 · 확인일: 2026-08-03