常见问题
本页按模块列出平台上常见的故障现象、可能原因、处置与责任方。各模块的功能说明与字段定义见对应模块页，本页不重复。
使用前提
排查前先确认账号可登录，且对应权限未设为「禁止」。
按模块排查
账号与权限
登录与账号相关的故障如下。
| 现象 | 可能原因 | 处置 | 责任方 |
|---|---|---|---|
| 提示「账号或密码错误」 | 密码有误；账号名包含前后空格 | 核对密码；移除账号名的前后空格；忘记密码时在登录页点击「忘记密码」，通过注册邮箱重置 | 用户本人 |
| 提示「登录失败次数过多，请稍后再试」 | 同一账号在 5 分钟内累计 5 次登录未成功，账号被锁定 15 分钟 | 等待 15 分钟后重试；或由管理员在运维监控的日志总览中解除锁定 | 用户本人、管理员 |
| 提示「IP 地址不在白名单中，无法登录」 | 平台启用了 IP 白名单，当前出口 IP 未登记 | 将当前出口 IP 提供给管理员加入白名单 | 管理员 |
| 提示「账号已经过期」 | 账号有效期已过 | 由管理员延长账号的有效期 | 管理员 |
| 登录后看不到部分菜单 | 角色默认模板不含该入口，或用户级模块权限被设为禁止 | 由管理员在用户编辑页的模块权限中开启对应权限，用户重新登录后生效 | 管理员 |
数据上传
上传与转码相关的故障如下。
| 现象 | 可能原因 | 处置 | 责任方 |
|---|---|---|---|
| 视频无法转换为 MCAP | 浏览器缺少 MediaStreamTrackProcessor 或 HTMLVideoElement.captureStream（Firefox 不提供前者） | 改用 Chrome 94+ 或 Edge 94+ 重新上传 | 用户本人 |
| 音频无法转换为 MCAP | 浏览器无法解码该音频文件 | 改用 MP3、WAV、AAC 或 Ogg 格式的音频文件 | 用户本人 |
| 上传失败或长时间停留在处理中 | 文件格式不受支持；网络中断；云存储连接不可用 | 核对文件格式；检查网络；确认云存储连接可用后重试 | 用户本人、管理员 |
| 重新上传与已删除数据集同名的文件 | 平台检测到同名的软删除数据集 | 选择恢复现有数据集或创建新数据集 | 用户本人 |
支持的接入方式、转码参数与前置条件见数据上传。
标注任务
任务创建、标注与审核环节的故障如下。
| 现象 | 可能原因 | 处置 | 责任方 |
|---|---|---|---|
| 标注数据被审核员打回 | 标注内容与标注口径不符，或存在无效标注 | 在任务详情页的「问题标注」标签页查看无效标注与反馈，修正后重新提交 | 标注员 |
| 任务无法进入「提交数据」 | 任务未流转到「检查合格」状态 | 完成审核并流转到「检查合格」后，由管理员或项目经理提交 | 审核员、项目经理 |
| 创建任务时提示「任务名称已存在」 | 任务名在全平台已被占用 | 更换任务名 | 项目经理 |
| 创建任务时提示「数据量不足以分配给所有标注员」 | 所选数据集数量少于标注员数量 | 减少标注员数量，或补充数据集 | 项目经理 |
| 创建任务时接口返回 403 | 在公开项目中创建任务，但创建者不是项目成员 | 由项目成员创建，或由管理员将创建者加入项目 | 项目经理、管理员 |
任务状态、字段与批量操作见标注任务；创建与指派步骤见新建标注任务。
数据导出
导出任务的故障如下。
| 现象 | 可能原因 | 处置 | 责任方 |
|---|---|---|---|
| 导出任务长时间排队 | 后台导出队列积压 | 减少并发导出，或由管理员查看并处理队列积压 | 项目经理、管理员 |
| 导出任务失败 | 数据量过大；存储空间不足；数据格式不符合所选导出格式 | 分批导出；由管理员检查存储空间；核对数据格式后重试 | 项目经理、管理员 |
导出格式、参数与配额见数据导出。
模型训练与推理
训练与推理的故障如下。
| 现象 | 可能原因 | 处置 | 责任方 |
|---|---|---|---|
| 训练任务失败 | 显存不足；数据格式错误；参数配置错误；网络中断 | 在训练详情页查看错误日志，按原因降低 batch_size、核对数据或参数后重新训练 | 项目经理、管理员 |
| 推理服务启动失败 | GPU 资源不足；模型文件不完整；配置错误；容器启动失败 | 查看服务 日志定位原因，修复后重新部署 | 项目经理、管理员 |
平台配置与后台任务
云存储
云存储连接的故障如下。
| 现象 | 可能原因 | 处置 | 责任方 |
|---|---|---|---|
| 云存储连接失败 | 认证信息错误；区域或端点填写错误；网络不可达；IP 白名单未放行 | 核对密钥、区域、端点与桶名；确认网络连通并放行 IP | 管理员 |
| 上传或导出提示目标存储不可用 | 存储凭据失效，或连接被停用 | 重新配置或启用一个可用的云存储连接 | 管理员 |
支持的存储类型与配置字段见云存储。
后台任务与队列
后台任务的故障如下。
| 现象 | 可能原因 | 处置 | 责任方 |
|---|---|---|---|
| 导入、转码或质检任务长时间等待 | 队列积压：任务过多或处理速度不足 | 在运维监控的后台任务中查看队列，暂停新任务、清理无用任务或增加资源 | 管理员 |
| 任务反复失败 | 源文件损坏或参数不受支持 | 在任务队列中查看失败原因，修复源文件或调整参数后重试 | 管理员、项目经理 |
队列、日志与登录锁定列表的查看方式见运维监控。
联系支持
| 渠道 | 联系方式 |
|---|---|
| 技术支持邮箱 | support@io-ai.tech |
| 技术支持电话 | (+86) 0755-88658665 |
相关页面
| 页面 | 用途 |
|---|---|
| 用户管理 | 账号、角色与模块权限的配置 |
| 模块权限 | 模块权限键的分组与配置步骤 |
| 数据上传 | 上传与转码的接入方式与前置条件 |
| 标注任务 | 任务状态机、任务详情与批量操作 |
| 云存储 | 对象存储连接的配置字段 |
| 数据导出 | 导出格式、参数与配额 |
| 模型训练 | 训练任务的创建与监控 |
| 模型推理 | 推理服务的部署与调用 |
| 运维监控 | 任务队列、系统日志与权限审计 |