常见问题
最后更新: 2026/11/2
登录与权限、管道与流程任务、实时任务的常见现象与处理办法，以及通用排障技巧。
概述
遇到问题时，先看运行记录里失败行的「说明」列，再进日志筛选「错误」级别，必要时用追踪 ID 串联各系统的日志。本文按模块整理了常见现象与处理办法。
登录与权限
| 现象 |
原因与处理 |
| 登录页一直是「初始化管理员」 |
系统里还没有任何账号，按提示创建第一个管理员（需要初始化令牌时，从部署日志或配置里获取）。如果已经创建过却仍出现，请联系维护者，不要重建数据库。 |
| 连续输错密码后无法登录 |
账号被临时锁定，等待锁定结束，或让管理员在「用户管理」里解锁。 |
| 登录后立刻被退出（非 localhost 访问） |
刷新 Cookie 带 Secure 标记，需要 HTTPS。请让管理员在前面加 HTTPS 反向代理。 |
| 看不到某个菜单 / 按钮是灰的 |
账号缺少对应权限，见 菜单为什么和别人不一样 和 权限速查，联系管理员调整角色。 |
| 数据源密码都显示「不可读取」 |
部署时的连接密钥变了或丢了。让管理员设回原密钥，并先确认备份。 |
管道与流程任务
| 现象 |
处理 |
| 目标表已存在但字段类型不匹配 |
回到向导第 3 步检查「目标类型」；自动建表只按来源推断，复杂类型建议先在目标库建好表。 |
| 运行很久后 socket timeout |
确认到目标库的网络空闲超时设置；拆小批、加索引、避开高峰；到运行日志里看具体卡在哪个阶段。 |
| 增量水位「拒绝续传」 |
PostgreSQL 时区时间戳的旧水位缺少偏移：核对目标数据后再重置位点，不要强行重跑。 |
| 「主键更新」后仍有重复 |
检查主键映射是否正确；追加模式下的重放本来就可能重复。 |
| 中文乱码 |
检查来源 / 目标的字符集与连接参数；MySQL 系请使用 utf8mb4。 |
| 流程任务「发布到生产」是灰的 |
可能任务正在运行、没有编辑权限，或生产版本已经是最新（没有待发布改动）。看按钮悬停提示。 |
| 脚本节点不可用 |
脚本节点默认关闭；需要部署时开启，并且账号有 task:script。 |
实时任务
| 现象 |
处理 |
| 启动失败：来源权限 / 参数不足 |
PostgreSQL 需要复制槽与 REPLICATION 权限；MySQL 需要 REPLICATION SLAVE/CLIENT 与 ROW 格式 binlog；按连接测试的提示补齐。 |
| 来源表结构变更后任务「等待处理」 |
确认目标表结构，按界面提示处理 DDL 跟随 / 孤儿列，不要直接删元数据。 |
| 位点不动、没有新数据 |
检查来源是否持续写入、复制槽是否被清理、网络是否闪断（运行日志里能看到重连退避）。 |
| 目标库写入失败 |
检查目标表结构 / 主键 / 权限；修复后任务会自动重试，不需要重建。 |
| 想从头重来 |
先暂停，再重置位点；注意会重放数据，追加模式下会产生重复写入。 |
部署与升级
| 现象 |
处理 |
容器或服务启动后健康检查是 waiting |
元数据库连不上：检查 DB_URL、网络、账号；修好后 POST /api/bootstrap/retry |
| 升级后登录、保存等请求返回 403 |
HTTPS 在反向代理终止时，需设置 FDL_TRUSTED_PROXIES 或 FDL_HTTP_ALLOWED_ORIGINS，见 安装与部署 |
| 恢复后数据源密码「不可读取」 |
连接密钥与库不匹配，见 备份与恢复 |
| 迁移失败或实例反复重启 |
停止替换其他实例，见 升级与回滚 |
通用技巧
- 先看「说明」列：运行记录里失败的行已经把原因写出来了。
- 用追踪 ID 串联：服务调用、任务运行、HTTP 节点共用一个追踪 ID，在日志、平台日志与对方系统里搜同一个 ID。
- 改配置前先备份：删除、清空、覆盖写入、重置位点都不是「撤销」就能回来的。
- 列表跳转更快：用
Ctrl+K 直接搜任务名，比一层层点菜单快。
相关文档
