VSCode에서 Flask 애플리케이션 디버깅: 포트 설정 가이드

Flask는 Python으로 웹 서버를 빠르게 구성할 수 있는 강력한 프레임워크입니다.

VSCode(Visual Studio Code)와 함께 Flask 애플리케이션을 디버깅할 때, 서버가 실행되는 포트를 원하는 대로 설정하는 것이 중요합니다.

이 글에서는 Flask 애플리케이션을 VSCode에서 디버깅하는 방법과 특정 포트에서 실행하도록 설정하는 방법을 설명하겠습니다.

1. Flask 애플리케이션 코드 설정

먼저, Flask 애플리케이션을 작성합니다. 아래는 예시 코드입니다:

from flask import Flask
from flask_cors import CORS

app = Flask(__name__)
CORS(app)

@app.route('/parse', methods=['POST'])
def parse_hwp():
    # 파싱 로직
    return "HWP 파일이 성공적으로 파싱되었습니다."

if __name__ == '__main__':
    app.run(host='0.0.0.0', port=8088, debug=True)  # 포트 8088로 설정

이 코드에서는 Flask 애플리케이션을 생성하고, `app.run()` 메서드를 통해 서버를 `0.0.0.0` 호스트에서 `8088` 포트로 실행하도록 설정했습니다. `debug=True`로 설정하면 코드 변경 시 자동으로 서버가 재시작됩니다.

2. VSCode의 `launch.json` 설정

이제 VSCode에서 Flask 애플리케이션을 디버그하기 위해 `launch.json` 파일을 설정합니다.

2.1. VSCode에서 `launch.json` 파일 열기

1. VSCode에서 좌측 사이드바의 `Run and Debug` 아이콘을 클릭합니다.
2. "create a launch.json file"을 선택합니다. 
3. Python 옵션을 선택합니다.

2.2. `launch.json` 파일 수정하기

다음은 기본적인 `launch.json` 설정 예시입니다:

{
    "name": "Python Debugger: parse_server",
    "type": "debugpy",
    "request": "launch",
    "module": "parse_server",  //Flask 앱 파일 이름으로 변경
    "env": {
        "FLASK_APP": "parse_server.py",
        "FLASK_DEBUG": "1"
    },
    "console": "integratedTerminal"
}

launch.json 파일 생성시 `module` 속성은 기본적으로 Flask로 지정되어 실행시 기본 포트인 5000 포트로 실행이 됩니다.

flask app.run()에서 설정한 포트로 실행하기 위해서 Flask 애플리케이션의 Python 파일 이름(`parse_server.py`)을 지정합니다. 

이 설정에서는 `args` 배열을 제거하여 VSCode가 Flask 애플리케이션을 직접 실행하도록 하였습니다.

3. 디버깅 시작하기

설정을 완료한 후, VSCode에서 `Run and Debug` 패널을 열고 방금 설정한 "Python Debugger: parse_server"를 선택한 다음, F5 키를 눌러 디버깅 모드를 시작합니다.

그러면 Flask 애플리케이션이 작성한 코드에서 설정한 포트인 `8088`로 실행됩니다.