fix: 본문이 2KB를 넘는 문서가 저장되지 않던 것

저장을 눌러도 요청이 나가지 않고 「저장하지 못했습니다.」만 떴다. 갓 만든
문서는 저장되고 글을 쓴 문서만 안 되어서 원인을 짚기 어려웠다.

명령의 신원을 만들 때 플랫폼은 `identity` 훅이 없으면 입력 전체를 쓴다.
그 신원은 `canonicalize` 를 지나고 거기에는 문자열 하나당 2KB 한도가 있다
(`contracts/query-keys.ts` 의 `maxStringBytes`). 본문이 그 한도를 넘는
순간 신원을 만들다 던지고, 명령은 `NOT_STARTED` 로 끝난다 — 전송 전이라
네트워크에도 콘솔에도 아무것도 남지 않는다. 실제로 걸린 문서의 본문은
11,222 바이트였다.

명령을 가리키는 이름은 「어느 문서에 대한 무슨 명령인가」이지 본문이 아니다.
문서 id 만 넘긴다. 같은 문서의 저장을 한 번에 하나만 돌리는 것이
`REJECT_WHILE_ACTIVE` 가 원하는 바이므로 이것으로 충분하다.

검사는 두 쪽을 같이 본다: 입력을 그대로 쓰면 실제로 던진다는 것과, 넘기는
신원은 본문 크기와 무관하다는 것. 앞의 절반이 없으면 한도가 사라져도
검사가 통과한다.

(cherry picked from commit 27f2182c7da2d6c5afbcf13ae0cf4ceaf6d9638c)
This commit is contained in:
DongHyeonka
2026-11-12 08:28:55 +09:00
parent 2fea5c58f4
commit 7420e29af0
2 changed files with 51 additions and 1 deletions
@@ -221,7 +221,23 @@ function publishSnapshotQueryDefinition(
});
}
function commandMutation<Input, Value>(
/*
명령을 가리키는 이름은 「어느 문서에 대한 무슨 명령인가」다. 본문이 아니다.
이 훅을 주지 않으면 플랫폼은 입력 전체를 명령의 신원으로 삼는데, 그 신원은
`canonicalize` 를 지나고 거기 문자열 하나당 2KB 한도가 있다(`contracts/query-keys.ts`).
본문이 2KB를 넘는 순간 신원을 만들다 던지고, 명령은 `NOT_STARTED` 로 끝난다 — 요청이
나가지 않으니 화면에는 이유 없는 「저장하지 못했습니다.」만 남았다. 갓 만든 문서는 본문이
비어 있어 통과하고 글을 쓴 문서만 저장이 안 되는, 원인을 짚기 어려운 모양이 된다.
같은 문서의 저장을 한 번에 하나만 돌리는 것이 `REJECT_WHILE_ACTIVE` 가 원하는 바이므로
문서 id 만으로 충분하다.
*/
export function STUDIO_COMMAND_IDENTITY({ documentId }: DocumentMutationInput<unknown>) {
return Object.freeze({ documentId });
}
function commandMutation<Input extends DocumentMutationInput<unknown>, Value>(
scope: ReturnType<typeof useServerStateScope>,
definitionId: string,
operationId: string,
@@ -239,6 +255,7 @@ function commandMutation<Input, Value>(
owner: "tech-log",
duplicatePolicy: "REJECT_WHILE_ACTIVE",
scope,
identity: STUDIO_COMMAND_IDENTITY,
invalidate: Object.freeze([]),
execute: (input, { signal, intent }) =>
studioMutationResult(operationId, () =>