Skip to content

docs(cloudflare): 坑 3 — wrangler pages deploy 多行 commit 被 CF 拒#16

Merged
RoboZephyr merged 1 commit into
mainfrom
docs/cloudflare-pages-multiline-commit-gotcha
May 17, 2026
Merged

docs(cloudflare): 坑 3 — wrangler pages deploy 多行 commit 被 CF 拒#16
RoboZephyr merged 1 commit into
mainfrom
docs/cloudflare-pages-multiline-commit-gotcha

Conversation

@RoboZephyr

Copy link
Copy Markdown
Owner

Summary

  • 新增 Pages 部署「坑 3」:wrangler pages deploy 默认把 git log -1 的多行 commit message(subject+body)发给 CF Pages deployment API,CF 拒,报 8000111 must be a valid UTF-8 string —— 错误信息有误导性,实际拒的是换行符不是 UTF-8
  • 给了两种修法:手动 --commit-message "$(git log -1 --pretty=%s)"、或写 scripts/deploy.sh 封装一次。
  • 错误调试速查表补 80001118000007(坑 1 提到但表里没收)。

发现来源

classics-learning 部署时踩到。历史 commits 都是单行中文 subject、没 body,所以没暴露;这次 commit 带了 body 才出错。

Test plan

  • 走读 diff,确认坑 3 描述跟坑 1/坑 2 的格式风格一致
  • 速查表新增行排版正确

CF Pages deployment API(错误码 8000111)不接受带换行的 commit message。
wrangler 默认会把 git log -1 的 subject+body 整块发过去,于是带 body 的提交
就会 deploy 失败。错误信息称"not valid UTF-8"是误导——实际拒的是换行符。

加了坑 3 完整说明 + 两种修法(手动 --commit-message "$(git log -1 --pretty=%s)"
或在项目里写 scripts/deploy.sh 封装)。错误调试速查表也补了 8000111 + 8000007。

发现来源:classics-learning 项目 deploy 时踩到,单行中文 commit 没事,
本次 commit 带了 body 才暴露。
@RoboZephyr RoboZephyr merged commit c1ebef7 into main May 17, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant