# Discourse 테마에서 잘못된 버전 목록

**URL:** https://meta.discourse.org/t/invalid-version-list-in-discourse-themes/407855
**Category:** Self-hosting
**Created:** [7월 17, 2026, 3:37오전 UTC](https://meta.discourse.org/t/invalid-version-list-in-discourse-themes/407855 "2026-07-17T03:37:28Z")
**Posts on this page:** 1
**Showing post:** 2

<div class="post-metadata">

### Author: ![elmuerte](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/elmuerte/32/456517_2.png) [@elmuerte](https://meta.discourse.org/u/elmuerte)
#### Post date: [7월 17, 2026, 8:38오전 UTC](https://meta.discourse.org/t/invalid-version-list-in-discourse-themes/407855/2 "2026-07-17T08:38:59Z")

</div>

정확히 말하면 아니지만, 그렇다고 볼 수도 있습니다.

그 에러가 발생하는 이유는 여러 가지가 있습니다. 가장 흔한 이유는 아마도 `.discourse-compatibility` 파일이 비어 있기 때문일 것입니다. [[1]](https://github.com/moin-Jana/sidebar-messages-section/blob/main/.discourse-compatibility), [[2]](https://github.com/moin-Jana/unhide-composer-fullscreen-toggle-for-tablets/blob/main/.discourse-compatibility), [[3]](https://github.com/NateDhaliwal/discourse-highlight-to-search/blob/main/.discourse-compatibility). (앞의 `#`는 주석 라인입니다)

실제로 이 경고는 Discourse가 현재 컴포넌트/플러그인의 “최신” 버전이 현재 Discourse 버전과 호환되는지, 아니면 컴포넌트/플러그인의 이전 버전으로 체크아웃해야 하는지 판단할 수 없음을 의미합니다.

컴포넌트/플러그인의 `.discourse-compatibility` 파일에는 Discourse 버전 범위를 해당 컴포넌트/플러그인의 특정 리비전으로 매핑하는 내용이 포함될 수 있습니다. Discourse가 매핑을 찾으면 최신 버전 대신 해당 리비전을 사용합니다. 이는 개발자가 이전 Discourse 버전과 호환되지 않는 변경 사항을 도입할 때 파일을 업데이트해야 함을 의미합니다. 호환성을 깨뜨리는 변경 사항을 하지 않았다면 파일은 비어 있게 되며, 따라서 해당 경고 메시지가 생성됩니다.

컴포넌트/플러그인이 최신 버전의 Discourse와 항상 호환되는지는 추측에 불과합니다.

저는 2026.1용 플러그인 개발을 시작했으므로, 이것이 Discourse의 최소 버전이 될 것입니다. 여전히 해당 버전(그리고 현재 최신 버전)을 기준으로 개발하고 테스트하고 있습니다. 더 이상 지원되지 않는 이전 Discourse 버전이 없으므로 `.discourse-compatibility` 파일은 비어 있으며, 이로 인해 이 경고 메시지가 생성됩니다. 2026.1의 지원이 종료되면 새로운 ESR으로 전환할 예정입니다. 그 시점부터 2026.1을 대상으로 테스트하지 않을 것이며, 따라서 `.discourse-compatibility` 파일을 업데이트하여 마침내 비어 있지 않게 만들 것입니다. 그때서야 제 플러그인에 대한 이 경고가 사라질 것입니다.

이 .discourse-compatibility 파일에 대한 추가 정보: [Introducing .discourse-compatibility: pinned plugin/theme versions for older Discourse versions](https://meta.discourse.org/t/introducing-discourse-compatibility-pinned-plugin-theme-versions-for-older-discourse-versions/156971)

---

_[View the full topic](https://meta.discourse.org/t/invalid-version-list-in-discourse-themes/407855)._
