Question 1

Ghost의 기본 댓글 섹션이 'TypeError: [object Promise] is not iterable' 오류와 함께 무한 로딩 스피너를 표시하는 이유는 무엇인가요?

Accepted Answer

이 오류는 Cloudflare와 같은 웹 애플리케이션 방화벽(WAF)이 댓글 API 엔드포인트를 차단할 때 발생합니다. 해결하려면 WAF가 Ghost 댓글 API에 대한 요청을 허용하도록 설정하세요. 임시 해결 방법으로 테마에서 `{{comments}}` 헬퍼를 제거하여 기본 댓글을 비활성화할 수 있습니다. 포럼 토론 참조: https://forum.ghost.org/t/native-comments-section-no-longer-mounts-on-6-41-1/62988/9

Question 2

Ghost 6.27.0 마이그레이션이 MySQL 8에서 'Referencing column and referenced column are incompatible' 오류로 실패하는 이유는 무엇인가요?

Accepted Answer

MySQL 8에서 이전 테이블(utf8mb4_general_ci)과 새 테이블(utf8mb4_0900_ai_ci) 간의 콜레이션 불일치입니다. 해결하려면 각 테이블에 대해 `ALTER TABLE table_name CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci;`를 사용하여 모든 테이블을 utf8mb4_0900_ai_ci로 변환하십시오. 또는 업그레이드 전에 MySQL 설정 파일(my.cnf)에서 기본 콜레이션을 utf8mb4_general_ci로 설정하십시오. 자세한 단계는 Ghost의 MySQL 문제 해결 문서를 참조하십시오. 영구적인 해결 방법을 위해 이슈 #27263을 추적하십시오.

Question 3

Ghost 6.29+로 업그레이드한 후 `/{year}-{month}-{day}-{slug}/`와 같이 하이픈이 포함된 Ghost 퍼머링크에서 발생하는 404 오류는 어떻게 해결하나요?

Accepted Answer

이 문제는 `path-match@1.2.4`가 `path-to-regexp@1.9.0`을 해석하는 Ghost 6.29.0–6.39.0의 라우팅 회귀로 인해 발생합니다. `:year-:month-:day-:slug`와 같이 하이픈으로 구분된 인접한 매개변수는 슬러그에도 하이픈이 포함되어 있는 경우 잘못 파싱됩니다. 예를 들어, 슬러그가 하이픈으로 구분된 마지막 부분으로 잘릴 수 있으며, 이로 인해 Ghost가 잘못된 게시물을 조회하여 404를 반환하게 됩니다.

안전한 해결 방법: `routes.yaml`에서 퍼머링크를 슬래시로 구분된 날짜 구성 요소로 변경하세요:

```yaml
collections:
  /reportagem/:
    permalink: /reportagem/{year}/{month}/{day}/{slug}/
    template: tag
    filter: primary_tag:reportagem
```

업데이트된 라우팅 구성을 업로드한 후 Ghost를 재시작하세요. 이전 URL에서 새 구조로 영구적인 301 리디렉션을 추가하세요. 예를 들면 다음과 같습니다:

```json
[
  {
    "from": "^/reportagem/([0-9]{4})-([0-9]{2})-([0-9]{2})-(.+)/$",
    "to": "/reportagem/$1/$2/$3/$4/",
    "permanent": true
  }
]
```

이전 동작은 Ghost 6.28.x 및 이전 버전의 `path-to-regexp@1.8.0`에서 정상적으로 작동했습니다. 이슈가 보고된 시점에는 수정이 대기 중이었으므로, 하이픈이 포함된 퍼머링크 형식을 복원하기 전에 패치된 Ghost 릴리스가 제공되면 업그레이드하세요.

Question 4

Ghost에서 사이트 시간대를 변경한 후 예약된 게시물이 한 시간씩 밀리는 이유는 무엇인가요?

Accepted Answer

이것은 Ghost의 `onTimezoneEdited` 리스너에 존재하는 DST 버그입니다. 사이트 시간대를 변경하면 Ghost는 설정이 변경된 날짜를 기준으로 하나의 UTC 오프셋 차이를 계산한 다음, 그 동일한 차이를 모든 예약된 포스트에 적용합니다. 포스트가 다른 일광 절약 시간 시즌에 예약되어 있는 경우(예: 여름/EDT에 시간대를 변경했지만 포스트가 겨울/EST에 예약된 경우), 포스트가 한 시간 어긋납니다. 예: 2027-01-15 뉴욕 현지 시간 10:00으로 의도된 포스트가 올바른 15:00Z 대신 14:00Z(현지 시간 09:00)로 저장됩니다. 해결 방법: 각 포스트의 시점을 개별적으로 다시 계산하는 PR #32148을 적용하거나(또는 이를 포함하는 Ghost 릴리스로 업그레이드하세요). 이 PR은 이전 시간대에서 예약된 시간을 읽고 DST 간격/중첩에 대한 Moment Timezone의 기존 규칙을 사용하여 새 시간대에 동일한 현지 벽시계 시간을 다시 적용합니다. 데이터베이스 마이그레이션이나 API 변경은 필요하지 않습니다. 패치 전까지의 우회 방법: 사이트 시간대를 변경한 후 날짜가 다른 DST 시즌에 해당하는 예약된 포스트를 수동으로 검토하여 다시 저장하거나, UTC 오프셋이 예약된 포스트의 날짜와 일치하는 시즌에 시간대를 변경하세요.

Question 5

Ghost 6.41에서 SES 메일 전송을 사용할 때 'SendEmailCommand is not a constructor' 오류가 발생하는 이유는 무엇인가요?

Accepted Answer

이는 Ghost 6.41.0에서 @tryghost/nodemailer@2.2.0의 호환되지 않는 SendRawEmailCommand 참조로 인해 발생하는 알려진 버그입니다. 반면 nodemailer@8.0.5는 SendEmailCommand를 기대합니다. 해결 방법: Ghost를 6.40.0 이하로 다운그레이드하세요. 개발팀이 main에서 수정했으며 곧 릴리스가 제공될 예정입니다. Ghost >6.41.0을 주목하세요.

Ghost

주요 기능

할 수 없는 것

사용 사례

태그

시작하기

유사한 프로젝트