报错参考

社区与社交功能报错

资源评论、评分、举报、收件箱等社交功能可能出现的报错及说明

本文档汇总 AstroBox 在资源评论、评分、举报、收件箱、个人资料等社区社交功能中可能向用户展示的报错信息。

一、Toast 弹窗报错

资源评论

资源详情页

触发位置消息说明
pages/resource/detail.tsx:146err.message ?? err资源详情获取失败
pages/resource/detail.tsx:160err.message ?? errAstroBox 资源信息获取失败
pages/resource/detail.tsx:279commentError?.message ?? commentError评论列表获取失败
pages/resource/detail.tsx:302err.message ?? errget_image_palette 调用失败
pages/resource/detail.tsx:373resource.comment.permissionHint无评论权限却尝试回复
pages/resource/detail.tsx:407err?.message ?? err提交回复失败
pages/resource/detail.tsx:431err?.message ?? err删除评论失败
pages/resource/detail.tsx:456err?.message ?? err点赞/取消点赞失败
pages/resource/detail.tsx:610err?.message ?? err发送顶层评论失败

评论详情页

触发位置消息说明
pages/resource/commentDetail.tsx:106error?.message ?? error评论详情获取失败
pages/resource/commentDetail.tsx:154err?.message ?? err提交回复失败
pages/resource/commentDetail.tsx:183err?.message ?? err删除评论失败
pages/resource/commentDetail.tsx:208err?.message ?? err点赞/取消点赞失败

评分

触发位置消息 Key说明
components/resource/detail/RatingCard.tsx:255resource.rating.submitSuccess评分提交成功
components/resource/detail/RatingCard.tsx:261err?.message ?? err评分提交失败

举报

触发位置消息说明
components/report/ReportDialog.tsx:51请先登录 AstroBox 账号（硬编码）举报时未登录
components/report/ReportDialog.tsx:55请填写举报说明（硬编码）举报原因为空
components/report/ReportDialog.tsx:71举报已提交（硬编码）举报提交成功
components/report/ReportDialog.tsx:76err.message / String(err)举报提交失败

收件箱

触发位置消息说明
components/inbox/InboxButton.tsx:118inboxError.message / String(inboxError)收件箱获取失败
components/inbox/InboxButton.tsx:141err.message / String(err)标记已读失败
components/inbox/InboxButton.tsx:174已全部标记为已读（硬编码）全部标记已读成功
components/inbox/InboxButton.tsx:176err.message / String(err)全部标记已读失败
components/inbox/InboxButton.tsx:193err.message / String(err)删除消息失败
components/inbox/InboxButton.tsx:232请先登录 AstroBox 账号（硬编码）未登录点击导航图标

个人资料

触发位置消息说明
pages/profile.tsx:218err?.message ?? String(err)公开资料获取失败
pages/profile.tsx:321profile.collections.queueDeviceUnknown收藏集入队时无法解析设备 ID
pages/profile.tsx:387profile.collections.queueAddedSummary + added + ignored收藏集批量入队完成
pages/profileEdit.tsx:194profile.edit.background.needMedia提取颜色时无媒体 URL
pages/profileEdit.tsx:208profile.edit.background.extractFailed颜色提取返回空
pages/profileEdit.tsx:211profile.edit.background.extractDone颜色提取成功
pages/profileEdit.tsx:240profile.edit.board.proRequired非 Pro 用户尝试添加看板
pages/profileEdit.tsx:276profile.edit.saved资料保存成功
pages/profileEdit.tsx:280err?.message ?? String(err)资料保存失败
pages/profileEdit.tsx:829profile.edit.board.linkPreview看板预览中点击链接
pages/profileCollections.tsx:108profile.collections.titleRequired收藏集标题为空
pages/profileCollections.tsx:127profile.collections.saved收藏集保存成功
pages/profileCollections.tsx:130err?.message ?? String(err)收藏集保存失败
pages/profileCollections.tsx:141profile.collections.deleted收藏集删除成功
pages/profileCollections.tsx:144err?.message ?? String(err)收藏集删除失败

二、Rust 后端返回错误

图片/数据工具

位置错误消息触发条件
frontapi/utils.rs:185image decode error图片解码失败
frontapi/utils.rs:188no valid pixels图片量化失败
frontapi/utils.rs:212invalid image dataBase64 解码失败
frontapi/utils.rs:219image download error图片下载失败
frontapi/utils.rs:222image read error图片读取失败
frontapi/utils.rs:225image_url or image_data required参数验证失败

三、WASM / 逻辑层抛错

位置错误消息触发条件
logic/api/astrobox/request.ts:162你的社交功能已被限制，解除时间：...后端返回 social-banned
logic/api/astrobox/request.ts:169账号已被封禁：...后端返回 user-banned
components/resource/detail/Hero.tsx:203OfficialV2 device map is not readyOfficialV2 设备映射未就绪
components/resource/detail/Hero.tsx:840clipboard unavailable剪贴板不可用

四、常见排查建议

报错建议操作
resource.comment.permissionHint确认账号已完成实名认证或满足评论条件
请先登录 AstroBox 账号先登录账号再使用社交功能
profile.collections.queueDeviceUnknown先连接设备并确保设备被正确识别
profile.edit.board.proRequired升级至 Creator Pro 以使用看板功能
你的社交功能已被限制等待限制解除时间到期，或联系客服
账号已被封禁联系 AstroBox 客服了解封禁原因
image decode error确认图片格式正确且未损坏
OfficialV2 device map is not ready等待设备映射加载，或刷新页面
profile.collections.titleRequired确保输入了收藏集标题
请填写举报说明填写举报原因后再提交

系统与框架级报错

系统框架、热更新、版本检查、底层通信等可能出现的报错及说明

概览

通过命令行或 Agent 与 AstroBox 交互的完整指南

大纲

一、Toast 弹窗报错资源评论资源详情页评论详情页评分举报收件箱个人资料二、Rust 后端返回错误图片/数据工具三、WASM / 逻辑层抛错四、常见排查建议