社区发布自动化的两个安静失败：免责声明勾选与内容白名单过滤

前言

昨天用自动化脚本往华为云社区发每日文章时，接连撞上两个非常"安静"的失败：点了发表没反应、提交被拒还不说原因。排查半天终于把文章发出去，把这两个坑的定位思路和修复方法整理成文，给同样在做社区发布自动化的同学省点时间。

一、坑一：免责声明勾选框，JS 赋值无效

发布页底部的"声明"一栏有个免责声明勾选框，不勾选的话"发表"按钮是灰色的，点击没有任何反应，也没有错误提示。

第一反应是用 JS 把它勾上：

cb.checked = true;
cb.dispatchEvent(new Event('change', {bubbles: true}));

执行后看起来成功，但按钮依然是灰的。查 DOM 才发现真相：这个勾选框根本不是 <input type="checkbox">，而是一个自绘的 <span id="agreementBox"> 组件，靠 CSS class 表达状态。

<span id="agreementBox" mate_data_ts="portal_v4_blog_Editingbox.click.免责声明"></span>

给它设置 checked 属性等于对着空气出拳。正确做法只有一种：真实鼠标点击。用 Playwright 的话就是：

await page.locator('#agreementBox').click()
await page.wait_for_timeout(800)
# 验证：className 里出现 "checked"
cls = await page.evaluate('document.getElementById("agreementBox").className')

勾选成功后 class 会从空变成 checked，"发表"按钮随之解禁。验证 class 比验证按钮颜色可靠得多。

通用教训：现代前端大量使用自绘表单组件，判断一个控件能不能用 JS 直接赋值，先看它的真实 DOM 结构。凡是靠 class 驱动状态的组件，都需要真实事件（真实点击或带完整事件链的 dispatch）。

二、坑二：内容白名单过滤，报错藏在弹窗里

勾选解决了，点发表却弹出一个"温馨提示"：抱歉！您的文章内容中短语请不在白名单中，您可以删除超链接后再次提交。

问题指向文章正文里的外部链接。逐处排查后确认：正文和代码块里出现的完整 URL（带协议头的跨站链接）就是触发点。处理方式是把完整链接改写成文字描述：

• 删掉所有协议头，完整域名改成"某某镜像站的某目录"这类表述；
• 代码块里必须出现路径的地方，拆开写或用占位描述；
• 改完后全文搜索协议关键字确认清零。

改完重新提交，一次通过，页面跳转到发布完成页。

通用教训：

1. 社区平台对正文里的外链普遍有过滤策略，写自动化发布脚本时，最好在提交前对内容做一次"链接清洗"，而不是等报错再返工；
2. 报错信息往往出现在自定义弹窗组件里，自动化流程要读取弹窗文本而不是盲目点确认按钮——盲点确认会把真实错误一次次关掉，看起来像"点了没反应"。

三、把两个修复固化成发布检查清单

现在的发布脚本在点发表前会依次执行：

1. 填标题、正文（真实键盘输入，编辑器内部状态才会更新）
2. 填摘要
3. 真实点击免责声明，校验 class 含 checked
4. 选择文章标签
5. 提交前：全文扫描协议头，命中则先清洗再提交
6. 点发表后：循环读取弹窗文本
   - 出现"确认发布"类按钮 → 点击
   - 出现错误文案 → 打印报错并终止，绝不盲点
   - URL 跳转到完成页 → 判定成功

这套清单跑通后，发布成功率从"碰运气"变成确定性流程。

写在最后

自动化发布的价值不在于快，而在于把失败显式化：每一步都有可校验的状态（勾选框的 class、按钮的禁用态、弹窗的文本、最终的 URL），任何一步不符合预期就立刻暴露，而不是静默失败。这两天的踩坑经验沉淀下来，就是一套可复用的发布协议。