Playwright 自动化发布文章踩坑实录:富文本编辑器的 4 个深坑与解法
先说结论:用 Playwright 向知乎/CSDN/百家号这类富文本编辑器自动灌内容,最大的坑不是选择器,而是选区状态、延迟弹层、静默丢块这三个隐蔽问题。本文记录我们内容自动化管线里真实踩过的 4 个深坑与最终解法,代码可直接复用。
最近在做多平台内容分发自动化(一篇文章同时发知乎/CSDN/百家号等),用 Playwright 驱动各家富文本编辑器时踩了一堆坑。这些坑在 demo 阶段都发现不了——内容只有几十字时一切正常,等到灌 2000+ 字的正式文章才集中爆发。以下按出现频率排序。
坑一:正文打进了标题框(选错 contenteditable)
现象:标题栏出现正文内容,正文区反而是空的。
根因:很多编辑器的标题栏内层也是一个 contenteditable 元素,且类名与正文编辑器同前缀。比如某编辑器标题是 FeEditorApp-xxx-title,正文是 FeEditorApp-yyy-editor——用 [contenteditable=true][class*="FeEditorApp"] 选择器,querySelector 按 DOM 顺序返回第一个匹配,恰好是标题。
解法:
/* 正确:排除标题区 */
div[contenteditable="true"][class*="FeEditorApp"]:not([class*="title"])
配合选区校验——document.getSelection().anchorNode 必须落在正文元素内:
(sel) => {
const e = document.querySelector(sel);
const s = document.getSelection();
return !!(e && s.anchorNode && e.contains(s.anchorNode));
}
注意:不要用 document.activeElement 判断——Lexical/Slate 系编辑器的内部选区状态与 activeElement 可能不一致,会出现"校验通过但打字进了标题框"的诡异现象。
坑二:execCommand 静默失效,长文只进了一部分
现象:document.execCommand('insertText', false, chunk) 分块注入 900 字正文,结果编辑器里只有 72 字。
根因:某些页面会在打字中途弹出引导浮层/推广弹窗,抢走焦点或打断选区,后续 chunk 全部丢失。而且 execCommand 在部分框架里会静默返回 false 或什么都不做。
解法:每块注入前校验选区,丢失则找回光标后重试;注入完成后核验编辑器字数,不足则清空重来:
// 每块注入前
if (!selectionInside(editorEl)) {
editorEl.focus();
placeCaretAtEnd(editorEl);
}
document.execCommand('insertText', false, chunk);
// 全部注入后
const len = editorEl.innerText.replace(/\s/g, '').length;
if (len < targetLen / 2) {
// 清空重灌:Ctrl+A → Delete → 重新分块注入
}
关键教训:永不信任注入成功,必须以编辑器实际字数为准做闭环校验。
坑三:延迟弹层反复出现,点击全被拦截
现象:点"发布"按钮没有任何反应,页面也不跳转。
根因:平台会在页面加载后延迟 2-5 秒弹出推广浮层(如"你的 AI 创作搭子"全屏引导图、居中模态框),时机完全随机——点击瞬间恰好被浮层盖住,element.click() 的真实鼠标事件被拦截。
解法:MutationObserver 实时守卫,弹层一渲染就移除(注意两个例外):
if (window.__guard) return;
const kill = () => {
document.querySelectorAll('.cheetah-modal-wrap').forEach(e => {
if (e.innerText.includes('确认发布')) return; // 发布确认框保留
if (e.querySelector('input[type=file]')) return; // 图片上传对话框保留
e.remove();
});
};
kill();
new MutationObserver(kill).observe(document.documentElement,
{childList: true, subtree: true});
两个例外必须处理:发布确认框删了就没法发布;图片上传对话框删了封面就没法传。这两个要在守卫里白名单化。
坑四:持久化档案被锁,浏览器启动即退
现象:launch_persistent_context 报"已在另一个运行中的浏览器会话中打开"后立即退出。
根因:主控进程重启后,旧会话的 Chrome 进程成为孤儿但仍锁着 user-data-dir。
解法:启动前按 profile 路径清理孤儿进程:
ps = subprocess.run(["powershell", "-Command",
f"Get-CimInstance Win32_Process | Where-Object {{ $_.Name -eq 'chrome.exe' "
f"-and $_.CommandLine -like '*{profile_name}*browser_profiles*' }} | "
"Select-Object -ExpandProperty ProcessId"], capture_output=True, text=True)
for pid in out.stdout.split():
subprocess.run(["taskkill", "/F", "/PID", pid], capture_output=True)
沉淀出的通用注入骨架
把以上坑全部处理后的稳健注入流程:
1. 安装 MutationObserver 守卫(白名单:发布确认框、上传对话框)
2. 真实点击正文编辑器 → 校验 document 选区在编辑器内(4 次重试)
3. 分块注入(100-150 字/块),每块前校验选区,丢失即找回
4. 核验编辑器字数 ≥ 预期一半,不足则清空重灌
5. 点发布前再跑一轮弹层清扫
6. 以 URL 跳转作为发布成功判据(不能只信点击成功)
这套骨架在我们管线里跑稳定了知乎专栏与 CSDN 两类差异巨大的编辑器(Lexical 与 CKEditor 4,两家的团队分别来自不同公司,实现思路完全不同——这也是为什么通用骨架比平台专属 hack 更有价值)。
关于我们
本文来自 铜莫智云技术部 的工程实践。我们在做企业内容自动化与 GEO(生成式引擎优化)系统时踩到了这些坑,整理出来希望对同样在做多平台发布的同学有帮助。对这套管线的技术细节感兴趣,欢迎评论区交流。
本文原创,转载请注明出处。