415 Unsupported Media Type: 원인과 해결 방법
1. 415 Unsupported Media Type란?
415 Unsupported Media Type은 클라이언트가 서버로 전송한 요청 본문의 콘텐츠 유형(Content-Type)이 서버에서 지원하지 않을 때 반환되는 HTTP 상태 코드입니다. 이 에러는 주로 API 요청이나 파일 업로드 과정에서 발생합니다.
2. 주요 원인
- 잘못된 Content-Type 헤더: 클라이언트가 잘못된 콘텐츠 유형을 지정했을 때.
- 서버의 미지원 콘텐츠: 서버가 해당 미디어 타입을 처리하지 못할 경우.
- 인코딩 문제: 본문의 데이터가 서버에서 지원하지 않는 형식으로 인코딩된 경우.
3. 415 에러의 영향
이 에러는 클라이언트와 서버 간의 데이터 전송 문제를 유발하며, 다음과 같은 영향을 미칩니다:
- API 요청 실패: 클라이언트가 서버와 통신할 수 없음.
- 파일 업로드 중단: 지원되지 않는 형식의 파일로 인해 업로드 실패.
4. 해결 방법
1) 올바른 Content-Type 헤더 설정
클라이언트가 요청 헤더에 올바른 Content-Type을 지정해야 합니다. 예를 들어:
Content-Type: application/json
2) 서버 설정 확인
서버가 요청한 콘텐츠 유형을 처리할 수 있도록 설정을 수정합니다. 예를 들어:
- Express.js: JSON 데이터를 처리하도록
body-parser 미들웨어 추가.
const express = require('express');
const app = express();
app.use(express.json()); // JSON 요청 본문 처리
app.post('/data', (req, res) => {
res.send("데이터 처리 성공");
});
app.listen(3000, () => console.log('서버가 실행 중입니다.'));
3) 지원되는 미디어 유형 확인
API 문서에서 서버가 지원하는 미디어 유형을 확인하고 요청을 조정합니다. 예를 들어:
- JSON 데이터:
application/json
- XML 데이터:
application/xml
5. 예제 코드
415 에러를 방지하는 Python Flask 예제:
from flask import Flask, request, jsonify
app = Flask(__name__)
@app.route('/process', methods=['POST'])
def process_data():
if request.content_type != 'application/json':
return jsonify({"error": "415 Unsupported Media Type"}), 415
data = request.json
return jsonify({"message": "데이터 처리 성공", "data": data})
if __name__ == '__main__':
app.run(debug=True)
6. 관련 HTTP 상태 코드
- 400 Bad Request: 요청이 잘못된 경우.
- 406 Not Acceptable: 서버가 요청된 콘텐츠를 제공할 수 없는 경우.
- 500 Internal Server Error: 서버 내부 오류 발생.
