114 lines
3.4 KiB
Markdown
114 lines
3.4 KiB
Markdown
# 트러블슈팅: SQLite "I/O operation on closed file" 에러
|
|
|
|
## 발생일
|
|
2026-02-27
|
|
|
|
## 증상
|
|
- 관리자 페이지에서 회원 검색 시 500 에러 발생
|
|
- 에러 메시지: `조회 실패: I/O operation on closed file.`
|
|
- 서버 로그에는 200 OK로 찍히지만 응답 body에 에러 포함
|
|
|
|
## 원인
|
|
|
|
### 1. SQLite 싱글톤 연결 문제
|
|
Flask의 멀티스레드 환경에서 `db_manager.get_sqlite_connection()`이 **싱글톤 연결**을 반환.
|
|
한 요청에서 연결을 닫으면 다른 요청에서 "closed file" 에러 발생.
|
|
|
|
**문제 코드:**
|
|
```python
|
|
conn = db_manager.get_sqlite_connection() # 싱글톤 연결 반환
|
|
cursor = conn.cursor()
|
|
# ... 작업 ...
|
|
# finally에서 conn.close() 호출 시 다른 요청에 영향
|
|
```
|
|
|
|
### 2. 존재하지 않는 테이블 참조
|
|
`product_category_mapping` 테이블이 DB에 없는데 쿼리 시도 → SQLite 에러 발생
|
|
|
|
## 해결 방법
|
|
|
|
### 1. 새 연결 사용 + finally에서 close
|
|
```python
|
|
conn = None
|
|
try:
|
|
conn = db_manager.get_sqlite_connection(new_connection=True) # 새 연결!
|
|
cursor = conn.cursor()
|
|
# ... 작업 ...
|
|
except Exception as e:
|
|
logging.error(f"에러: {e}")
|
|
return jsonify({'success': False, 'message': str(e)}), 500
|
|
finally:
|
|
if conn:
|
|
try:
|
|
conn.close()
|
|
except:
|
|
pass
|
|
```
|
|
|
|
### 2. 없는 테이블 조회 시 예외 처리
|
|
```python
|
|
try:
|
|
cursor.execute("SELECT * FROM product_category_mapping WHERE ...")
|
|
# ...
|
|
except Exception:
|
|
pass # 테이블 없으면 무시
|
|
```
|
|
|
|
## 수정된 API 목록
|
|
|
|
| API | 파일 | 커밋 |
|
|
|-----|------|------|
|
|
| `/api/members/search` | app.py | 87a56d0 |
|
|
| `/api/members/history/<id>` | app.py | 87a56d0 |
|
|
| `/admin/search/user` | app.py | 1414bb1 |
|
|
| `/admin/search/product` | app.py | 1414bb1 |
|
|
| `/admin/user/<id>` | app.py | 4691d65, 94a8df6 |
|
|
|
|
## dbsetup.py 수정사항
|
|
|
|
`get_sqlite_connection()` 메서드에 `new_connection` 파라미터 추가:
|
|
|
|
```python
|
|
def get_sqlite_connection(self, new_connection=False):
|
|
"""
|
|
SQLite 연결 반환
|
|
- new_connection=True: 새 연결 생성 (API 요청마다 독립적 연결 필요시)
|
|
- new_connection=False: 기존 싱글톤 연결 반환 (기본값, 하위 호환성)
|
|
"""
|
|
if new_connection:
|
|
conn = sqlite3.connect(self.sqlite_path, check_same_thread=False)
|
|
conn.row_factory = sqlite3.Row
|
|
return conn
|
|
|
|
# 기존 싱글톤 로직
|
|
if self._sqlite_conn is None:
|
|
self._sqlite_conn = sqlite3.connect(self.sqlite_path, check_same_thread=False)
|
|
self._sqlite_conn.row_factory = sqlite3.Row
|
|
return self._sqlite_conn
|
|
```
|
|
|
|
## 추가 수정사항
|
|
|
|
### CDN 차단 문제
|
|
Edge 브라우저의 Tracking Prevention이 cdnjs.cloudflare.com 차단
|
|
→ lottie.min.js를 로컬 파일(`/static/js/lottie.min.js`)로 변경
|
|
|
|
**커밋:** 866d10f
|
|
|
|
## 교훈
|
|
|
|
1. **Flask 멀티스레드 환경에서 SQLite 연결은 요청마다 새로 생성**해야 안전
|
|
2. **API 응답은 HTTP 상태코드로 판단하지 말고 body의 success 필드 확인**
|
|
3. **없을 수 있는 테이블/컬럼 조회는 try-except로 감싸기**
|
|
4. **CDN 의존성은 로컬 fallback 준비**
|
|
|
|
## 관련 커밋
|
|
|
|
```
|
|
94a8df6 fix: product_category_mapping 테이블 없을 때 에러 무시
|
|
4691d65 fix: /admin/user/<id> SQLite 연결 에러 해결
|
|
866d10f fix: lottie CDN을 로컬 파일로 변경
|
|
1414bb1 fix: /admin 사이드바 검색 SQLite 연결 에러 해결
|
|
87a56d0 fix: /api/members/* SQLite 연결 에러 해결
|
|
```
|