Question 1

TypeScript 6으로 업그레이드한 후 '@payloadcms/next/css' 임포트에서 발생하는 TS2882 오류를 수정하는 방법은?

Accepted Answer

`src/payload-css.d.ts` 파일을 생성하고 `declare module '@payloadcms/next/css';`를 추가하세요. 이는 side-effect import를 위한 누락된 타입 선언을 제공합니다. Payload는 향후 업데이트에서 공식 타입을 포함할 가능성이 높습니다.

Question 2

Payload CMS 이메일 어댑터에서 nodemailer 취약점 GHSA-vvjj-xcjg-gr5g을 해결하는 방법

Accepted Answer

@payloadcms/email-nodemailer를 최신 버전으로 업그레이드하세요 (수정 사항은 PR #16664를 통해 3.x 버전에 포함되었습니다). 패치된 nodemailer 요구 버전은 >=8.0.5입니다. 즉시 업그레이드가 불가능할 경우, 패키지 매니저 오버라이드를 사용하여 보안 버전을 강제로 적용하세요. pnpm의 경우 package.json에 다음을 추가하십시오: "pnpm": { "overrides": { "nodemailer@<8.0.5": ">=8.0.5" } }. npm의 경우 "overrides": { "nodemailer": ">=8.0.5" }를 사용하십시오. 그런 다음 'pnpm install' 또는 'npm install'을 실행하여 적용하세요. Payload CMS 릴리스에서 공식 업데이트를 주시하십시오.

Question 3

Payload CMS에서 @payloadcms/db-mongodb를 사용할 때 높은 심각도의 NoSQL 인젝션 취약점(GHSA-wpg9-53fq-2r8h)을 수정하는 방법은?

Accepted Answer

@payloadcms/db-mongodb (3.84.1)에 고정된 Mongoose 버전 8.15.1이 영향을 받습니다. 공식 업데이트가 출시될 때까지의 임시 방편으로, 패키지 관리자에서 Mongoose를 >=8.22.1로 재정의하세요. pnpm의 경우 package.json에 다음을 추가하십시오: `"pnpm": { "overrides": { "mongoose@<8.22.1": ">=8.22.1" } }`. 그런 다음 `pnpm install`을 실행하십시오. 이 패치 업데이트는 예상되는 호환성 문제가 없습니다. Payload 저장소를 주시하여 향후 릴리스에서 영구적으로 고정 버전을 올릴 때를 대비하십시오.

Question 4

Payload MCP 업데이트 도구를 등록할 때 "convertedFields.partial is not a function" 오류를 수정하는 방법

Accepted Answer

이 문제는 `@payloadcms/plugin-mcp`에서 발생하는데, TypeScript의 `transpileModule` 출력이 `"use strict";` 프롤로그로 시작하기 때문입니다. 플러그인은 이를 `new Function('z', 'return ' + output)`으로 평가하므로, 함수가 Zod 객체 대신 문자열 `"use strict"`를 반환합니다. 평가하기 전에 프롤로그를 제거하도록 `convertCollectionSchemaToZod.ts`를 수정하세요:

```ts
const output = transpileResult.outputText
  .replace(/^["']use strict["'];?\s*/, '')
  .trim()

const convertedFields = new Function('z', `return ${output}`)(z)
```

또한 `ZodRecord`는 `.partial()`을 제공하지 않으므로, `z.record(z.any())` 폴백을 ZodObject 호환 스키마로 교체하세요:

```ts
return z.object({}).passthrough()
```

임시 해결 방법으로 TypeScript를 5.9.3으로 다운그레이드하세요:

```bash
npm install -D typescript@5.9.3
```

Question 5

TypeScript 6에서 Payload MCP 오류 "convertedFields.partial is not a function"을 해결하는 방법?

Accepted Answer

이 문제는 TypeScript 6가 생성된 Zod 스키마를 트랜스파일할 때 `@payloadcms/plugin-mcp` 3.84.1에 영향을 미칩니다. TypeScript 6는 `"use strict";`를 맨 앞에 추가하며, 그러면 플러그인의 `new Function('z', 'return ' + outputText)(z)`가 `ZodObject` 대신 해당 문자열을 반환하게 됩니다.

즉시 적용 가능한 해결 방법: TypeScript를 프로젝트에서 사용 중인 5.x 라인으로 다운그레이드하세요. 예를 들어:

```bash
pnpm add -D typescript@~5.7.3
# or
npm install -D typescript@~5.7.3
```

의존성을 다시 설치하고 개발 서버를 재시작하세요. 그러면 MCP `initialize` 요청이 성공할 것입니다.

영구적인 플러그인 패치: `packages/plugin-mcp/src/utils/schemaConversion/convertCollectionSchemaToZod.ts`에서 트랜스파일된 출력을 평가하기 전에 지시문 프롤로그를 제거하세요:

```ts
const outputText = transpileResult.outputText.replace(
  /^\s*(?:"use strict"|'use strict')\s*;\s*/,
  '',
)

return new Function('z', 'return ' + outputText)(z)
```

`pnpm patch` 또는 `patch-package`로 이 패치를 적용한 다음 다시 빌드하고 재시작하세요. 또는 플러그인이 트랜스파일러 옵션에서 strict directive 생성을 비활성화할 수도 있지만, 프롤로그를 제거하는 것이 더 견고한 수정 방법입니다.

Payload

주요 기능

할 수 없는 것

사용 사례

태그

시작하기

유사한 프로젝트