问题排查
42-海报设计 · 2026-10-12 · 3.0 KB
它的故障面很窄：要么是合成引擎/字体这类环境问题，要么是素材与图层的问题 ⇒ 按这篇的顺序查，基本十步内定位。
本专题手工维护（2026-10-12 建）；⚠ 报错原话与界面文案以应用当前版本为准（本页快照 2026-10-12）。
一、先按顺序查（30 秒定因）
① 现象是"点不动 / 没反应" ⇒ 先确认你在自己的画布上（沙箱里被硬门拦掉，见 §二 第 7 条）✓
② 现象是"合成失败 / 报错" ⇒ 看报错原话对应 §三 哪一条（多数直接说明了原因与改法）✓
③ 现象是"成品不对（越界 / 看不清）" ⇒ 引擎会主动提示，按提示调位置、字号、描边 ✓
二、按现象查（对照表）
| 现象 | 最可能的原因 | 处置 |
|---|---|---|
| 1. 点「预览&输出」直接失败，提示合成引擎不可用 | 本机合成引擎缺失（随包资源异常，通常只有非正常安装才会出现） | 见 §三 第 1 条 ⇒ 属于环境问题，报障处理 ✓ |
| 2. 提示图层被全部隐藏 | 你把所有图层的"眼睛"都关了（隐藏层不参与合成） | 在层级行点开「眼睛」，或删掉隐藏层 ✓ |
| 3. 提示还没有任何图层 | 只在节点上放了底图素材，但设计里没有图层 | 用左栏「更换底图」或顶栏「底」加一张底图；也可以先套一个行业模板起稿 ✓ |
| 4. 提示海报素材文件不存在 | 某个图片图层引用的文件被移动 / 删除 / 改名了 | 找到那个图层「换图…」重选；⚠ 之后别在系统里挪动已入稿的素材 ✓ |
| 5. 成片里某些字整段空白 | 用了只含部分汉字的字体（手写 / 书法类） | 换回预置字体（黑体 / 雅黑 等），或给该字体补字 ✓ |
| 6. 预览看着正常、导出后字不见了 / 变字体 | 同上：引擎找不到该字体 ⇒ 会回落渲染 | 看 §三 第 5、6 条 ✓ |
| 7. 在 AI 会话里让它做海报，被拒绝 | 人机协同硬门：海报设计与视频剪辑不许在沙箱画布做 | 到界面上手动施工 —— ⚠ 这不是故障，是设计 ✓ |
| 8. 文字越出画布、被裁掉 | 位置 / 字号超了可见范围 | 按提示缩小字号或挪位置；或改「自动折行 / 折行+缩字」＋「最多行数」✓ |
| 9. 文字看不清（压不住底） | 文字与底色对比度太低 | 加描边、加色块背景盒，或换亮/暗字色 ✓ |
| 10. 换了底图，画布尺寸没变 | ✅ 这是对的（尺寸不跟底图走） | 要改尺寸 ⇒ 顶栏「尺寸」手动改＋锁 ✓ |
三、报错原话逐条（照抄应用提示）
1）合成引擎不可用
本地引擎：ImageMagick(magick) 不可用，无法合成海报。请把 portable magick 放入 resources/bin/imagemagick/ 或加入 PATH
⇒ 这是本机环境问题（该组件随包提供，正常安装不会缺）⇒ 按报障处理（见 §六）✓
2）图层全被隐藏
本地引擎：海报设计的 N 个图层被全部隐藏了（隐藏层不参与合成）——在层级行点开「眼睛」，或删掉隐藏层后重试
3）还没有任何图层
本地引擎：海报设计还没有任何图层（design.layers 为空）——用面板左侧「更换底图」或顶栏「底」加一张底图，也可以先「起稿」套一个行业模板
4）素材文件不存在
本地引擎：海报素材文件不存在：图层[image] 引用=… ⇒ 解析到 …（该路径没有这个文件）
5）字体回落（找不到你指定的字体）
… ⇒ 已改用**黑体（simhei）**渲染：…
6）连黑体也找不到
… ⇒ ⚠ 连黑体也找不到 ⇒ 将用 ImageMagick 默认字体，**中文很可能整层画不出** —— 请装入黑体或导入字体
7）文字越界
…: 文字渲染后越出画布 …px（可见盒 … / 画布 W×H，…）——请调整位置或缩小字号
8）对比度偏低
…: 文字与底色对比度偏低（实测底区平均灰度 …，字色 …，估算对比度 …:1 < 2:1）——建议加深色描边/阴影/背景盒或改亮字色
9）底图必须真是图片
底图需为图片文件（文件名），未上传
10）面板内的几条提示（不是故障，是自愈）
| 面板提示 | 意思 |
|---|---|
已自动修复 N 个图层缺失的 id… | 载入旧工程时自动补 id（不补会"全选到所有层、选不中单独一层"）✓ |
已把节点底图接入设计画布（画布保持 W×H；要跟随底图用顶栏「尺寸」✓） | 节点上的底图被自动接进设计（画布尺寸保持不变）✓ |
载入失败：… / 保存失败：… | 工程档读写失败 ⇒ 换一个位置再存 / 先确认文件没被占用 ✓ |
四、字体与缺字（最"玄"的一类，其实有规律）
- 引擎逐字回落：某个字在你选的字体里没有 ⇒ 那个字换字体渲染；整套都取不到 ⇒ 回落黑体；
- 黑体也取不到 ⇒ 用引擎默认字体 ⇒ 中文很可能整层画不出来（这就是"预览好好的、导出字没了"的常见原因）✓
⇒ 对策：正文用预置字体；特殊字体只用在少量标题字，并先试一小段 ✓
五、越界与对比度（引擎会主动提醒你）
引擎在合成时会检查并在结果里提示，这两条不是报错，是改进建议：
- 文字越出画布 ⇒ 缩小字号 / 挪回可见区 / 改用折行；
- 对比度偏低（它会给出实测灰度与估算对比度）⇒ 描边 / 背景盒 / 换字色 ✓
⇒ 建议把这两条当"出厂质检"看：提示能消掉，成品通常就能交付 ✓
六、要报障时，把这四样一起给
- 画布 / 节点：哪张画布、哪个海报节点（能截图最好）；
- 操作：点了什么（预览&输出 / 套模板 / 载入 / 另存为…）＋ 大概时间；
- 报错原话：整句照抄（尤其 §三 那几条，一句就能定位）；
- 产物去向：产物应该落在资产库 /「画布产出库」⇒ 说明"那里有没有" ✓
⚠ 一条纪律："点不动"先分沙箱还是正常画布 —— 沙箱里的"点不动"是硬门，不是故障 ✓
来源：E:/workbuddyProj/unlimitCanvas/ai_manual/poster_design/04-问题排查.md