[해결방법] 노션 db 조회 안될 시

Question

분명히 노션 세팅 잘 했고 연결까지 했는데 데이터베이스 조회 안 되는 분들은 참고해주세요.   강의 영상 촬영 날짜가 아마도 2025년 09월 이전으로 생각 됩니다.   그 이후에 노션 API 버전이 바뀌면서 데이터베이스 조회가 안 되는게 원인입니다. [ 노션 API 업그레이드 가이드 ] https://developers.notion.com/guides/get-started/upgrade-guide-2025-09-03   해결 방법은 2가지인데 API를 구버전을 쓰도록 프롬프트를 유도하거나, 신규 API 버전에 맞춰서 해야 하는데 신규 버전은 "데이터베이스 ID"가 아닌 "데이터베이스 소스 ID"를 필요로 합니다.   [ 구버전 프롬프트 ] 노션 api를 "2022-06-28" 버전으로 사용하고 관련 코드 전부 수정해줘.   [ 최신 버전 해결 방법 ]   데이터베이스를 열면 위 사진처럼 보일텐데   새로 만들기 왼쪽에 설정 누르면 밑에서 3번째에 데이터 소스 관리 있습니다.   소스 관리에서 위 사진처럼 데이터 소스 ID 복사하시고 그 값을 env에 넣으시면 됩니다.

gymcoding · Answer

안녕하세요! 소중한 정보 공유 감사합니다 🙂 참고로 강의 영상은 2025년 10월에 촬영되었고, Notion API 최신 버전(2025-09-03) 변경사항이 이미 반영되어 있어요 🙂   https://github.com/gymcoding/invoice-web/blob/main/src/lib/notion.ts 그리고 공유해 주신 내용 중에 좋은 포인트가 있는데요, 클로드 코드가 노션 API를 구버전으로 인식하는 경우가 실제로 있을 수 있어요. AI 모델이 최신 스펙 업데이트를 아직 학습하지 못했을 수 있거든요. 이럴 때 공유해 주신 것처럼 API 버전이나 관련 컨텍스트를 프롬프트에 넣어주는 건 정말 좋은 접근이에요 👍 좋은 정보 공유 감사합니다 🙏

communityai8509 · Answer

안녕하세요, 인프런 AI 인턴입니다. For Citizen님. 노션 API 버전 변경으로 인해 데이터베이스 조회 문제가 발생하고 있는 상황에서 어떻게 해결할 수 있는지 설명해주셔서 감사합니다. 이번 이슈는 분명 많은 분들이 겪고 있는 문제일 것 같습니다. 여러분들의 개발 프로젝트에 대한 업데이트가 필요해 보여 해결책을 간단히 요약해드리겠습니다. 문제 발생 원인 : 노션 API는 2025년 9월에 업데이트 되면서, 기존 데이터베이스 ID 대신 데이터 소스 ID를 필요로 하게 되면서 문제가 발생하고 있습니다. 해결 방법 : API 버전 다운그레이드 : 기존 버전의 API(예: &ldquo;2022-06-28&rdquo;)를 사용하고 계신 경우 해당 버전을 유지하면서 코드를 수정해보시는 것도 하나의 방법입니다. 최신 API 버전 적용 : 노션 데이터베이스를 열고 &lsquo;데이터 소스 관리&rsquo;에 접근합니다. &lsquo;데이터 소스 ID 복사&rsquo; 옵션을 통해 소스 ID를 얻고, 해당 ID를 환경 변수로 설정하여 사용합니다. 참고 이미지를 통해 설정 경로 및 옵션들을 확인하실 수 있습니다. 관련 링크로 노션 API의 업그레이드 가이드를 확인하실 수 있습니다: 노션 API 업그레이드 가이드 제가 제공한 방법이 도움이 되길 바라며, 코드 작성에 있어서 어려움이 있을 경우 Notion API 문서 에서 추가적인 정보를 확인하거나, 기존 수강생 및 강사님의 추가적인 도움을 요청하실 수 있습니다. 저는 질문자님의 이해를 돕고자 지식공유자님의 기존 답변을 참고하여 유사한 답변 링크를 추천해드리고 있습니다. 현재 베타 기능으로 답변이 만족스럽지 않을 수 있는 점 양해 부탁드립니다. 🙏 추가적으로 궁금한 점이 있으시면, 이어서 질문해 주세요. 곧 지식공유자께서 답변해 주실 것입니다.