×
¥
查看详情
🔥 会员专享 文生文 用户体验

安卓错误消息设计专家

👁️ 118 次查看
📅 Nov 30, 2025
💡 核心价值: 本提示词专为安卓应用开发场景设计,能够根据具体错误场景生成精准、专业且用户友好的错误提示信息。通过系统化分析错误类型、影响范围和解决方案,确保错误消息既符合技术规范又具备良好的用户体验。适用于开发调试、用户支持、测试验证等多种业务场景,帮助开发者快速创建高质量的异常处理机制。

🎯 可自定义参数(4个)

错误场景
具体的错误场景描述
错误级别
错误的严重程度级别
目标用户
错误消息的目标受众类型
输出语言
错误消息的输出语言

🎨 效果示例

  • 错误标题:Critical|Room 数据库迁移缺失(4→5)导致首启崩溃

  • 错误详情:

    • 触发场景:从应用版本 4 升级到版本 6 后,Application.onCreate 在初始化 Room 数据库时立即崩溃。
    • 异常形态:抛出 IllegalStateException;堆栈包含 androidx.room.RoomOpenHelper.validateMigration。
    • 根因分析:缺少版本 4→5 的必需迁移,Room 在打开数据库时进行架构校验,发现升级路径不完整(v4→v6 必须包含 4→5→6 或具备有效回退策略),因此拒绝打开数据库并抛出异常。
    • 复现方式:安装 v4 → 升级到 v6 → 冷启动应用,100% 复现。
    • 日志关键词(便于检索):
      • IllegalStateException
      • RoomOpenHelper
      • validateMigration
      • required migration 4->5 not found / missing migration 4→5
      • schema/identity verification failed
  • 影响范围:

    • 受影响用户:所有从 v4 升级到 v6 的用户。
    • 影响表现:冷启动 100% 崩溃,应用无法进入主界面。
    • 数据风险:采用“清除数据/卸载重装”等临时绕过手段将导致本地数据被清空,需提前评估与告知。
  • 解决方案:

    • 临时绕过(仅用于内测/应急,存在数据清空风险):
      • 用户侧操作:指导受影响用户清除应用数据或卸载重装,以获得与 v6 匹配的全新数据库。
      • 代码侧快速兜底(应尽量限域使用,发布稳定迁移后移除):
        • 在构建器中使用 fallbackToDestructiveMigrationFrom(4),仅针对从 v4 升级的场景进行破坏性回退(清表重建),避免影响其它版本路径。 示例(Kotlin): val db = Room.databaseBuilder(context, AppDatabase::class.java, "app.db") // .fallbackToDestructiveMigrationFrom(4) // 应急用,发布正式迁移后移除 .build()
      • 运行时兜底:对数据库初始化增加异常捕获与日志上报,避免应用直接崩溃,可在启动流程中给出引导(用于灰度/内测,不建议对正式用户长期使用)。
    • 正式修复(推荐):
      1. 补齐迁移链并注册:

        • 实现并注册 MIGRATION_4_5,确认 MIGRATION_5_6 已实现并注册。
        • 使用 addMigrations(MIGRATION_4_5, MIGRATION_5_6) 确保 v4→v6 升级路径完整。
        • 如满足条件,可评估使用 @AutoMigration(from = 4, to = 5)(若变更可被自动迁移覆盖),并在必要时提供 Spec 实现。 示例(Kotlin,省略具体 SQL 以避免暴露表结构): val db = Room.databaseBuilder(context, AppDatabase::class.java, "app.db") .addMigrations(MIGRATION_4_5, MIGRATION_5_6) .build()

        val MIGRATION_4_5 = object : Migration(4, 5) { override fun migrate(db: SupportSQLiteDatabase) { // 按 v5 版本的设计执行结构/数据变更 // db.execSQL("...") // 根据实际变更补全 } }

      2. 明确回退策略:

        • 对不再支持的更低版本,使用 fallbackToDestructiveMigrationFrom(<低版本号列表>) 有限度放开破坏性回退,避免使用全量的 fallbackToDestructiveMigration 造成误删。
      3. 引入迁移测试与校验:

        • 使用 MigrationTestHelper 在 CI 中覆盖 v4→v6、v5→v6、全新安装 v6 的用例,校验迁移与数据一致性。
        • 启用并提交 Room 的 schema 导出文件,开启严格校验,防止后续版本再次缺失迁移。
      4. 启动流程健壮性(可选优化):

        • 将数据库初始化从 Application.onCreate 解耦或懒加载;初始化失败时提供可恢复路径与日志上报,避免把不可恢复的迁移错误直接转化为应用级崩溃。
  • 技术参考:

  • 错误标题:支払いを完了できませんでした(タイムアウト)

  • 错误详情: 通信が不安定なため、支払い処理が時間内に完了しませんでした。モバイルデータからWi‑Fiへの切り替えが発生した可能性があります。 この取引は成立しておらず、注文番号は発行されていません。現時点で請求は確定していません(カード明細に一時的な保留が表示される場合がありますが、通常は自動で解消されます)。

  • 影响范围:

    • 今回の支払いは成立していません(商品やサービスはまだ手配・反映されません)。
    • 再度の支払い実行が必要です。
    • 不安定な通信環境で繰り返すと、処理が遅延・重複申込の不安につながる可能性があります。
  • 解决方案:

    • ネットワークを確認し、安定した接続(Wi‑Fiに固定する、または電波状況の良い場所)で再試行してください。
    • 連続タップはお控えください。[支払う] の結果が表示されるまでお待ちください。
    • 取引状況は「注文履歴」で確認できます。未表示の場合は決済は未成立です。
    • 繰り返し失敗する、または不明な請求がある場合はサポートへご連絡ください。下記の「日時」と「セッションID」をお伝えいただくと確認がスムーズです。
    • 推奨アクション(ボタン):
      • 主ボタン:再試行
      • 副ボタン:注文履歴を見る
      • テキストボタン:サポートに連絡

    コピーできる情報(サポート向け):

    • 日時:{YYYY-MM-DD HH:mm:ss(ローカル時刻)}[コピー]
    • セッションID:{SESSION_ID}[コピー]
  • 技术参考:

  • Title: Scan Login — Camera permission denied (Android 14), preview black with SecurityException

  • Details:

    • Severity: Info (tester-facing notice)
    • Module: QR Scan Login
    • Platform: Android 14 (first entry to scanner)
    • Symptom: Viewfinder shows black screen; a SecurityException is thrown when initializing camera after the permission prompt is quickly dismissed/denied.
    • Root cause: Camera permission not granted; camera start/bind triggers SecurityException due to missing runtime permission.
    • Exception keyword (for log search): SecurityException related to camera access/permission denial
    • Reproduction path (with prerequisites):
      • Preconditions:
        • Device on Android 14
        • App freshly installed or camera permission not yet granted
        • Network available (for later scan verification)
      • Steps:
        1. Launch the app and navigate to Scan Login.
        2. When the system camera permission dialog appears, dismiss or tap Don’t allow.
        3. Observe: viewfinder stays black; a SecurityException is logged.
  • Impact:

    • Scope: Scan Login camera preview and QR decoding are blocked on Android 14 when camera permission is denied.
    • User impact: QR codes cannot be scanned until the camera permission is granted.
    • Persistence: Issue persists across sessions until permission is manually allowed.
  • Resolution:

    • Grant camera permission via system settings:
      1. Open Android Settings > Apps > [Your App] > Permissions > Camera.
      2. Set to Allow while using the app.
      3. Return to the app and re-open Scan Login.
    • Verification points (after allowing permission):
      • The camera preview renders live frames (no black screen).
      • No SecurityException appears in logs during camera initialization.
      • Scanning a test QR code succeeds and proceeds to the expected login flow.
      • The app does not re-prompt for permission once granted.
    • Test data to record:
      • Device brand/model
      • Android version (e.g., 14, build number if available)
      • App version/build (versionName/versionCode)
      • Camera permission state before/after (Denied/Granted)
      • Repro steps taken and observed behavior (black preview, timestamps)
    • Log capture (avoid personal data; use a non-sensitive test QR):
      • Start recording before opening Scan Login:
        • adb logcat -c
        • adb logcat -v time | tee scan_login_cam_perm_denied.log
      • Reproduce the issue; stop capture after observing the black preview.
      • Key tags to look for: CameraX/Camera2/CameraManager/CameraService, PermissionManager, ActivityTaskManager, SecurityException
      • Optional focused filter (run in a second shell while full capture runs):
        • adb logcat -v time | grep -E "SecurityException|Camera|Permission"
    • Screenshot guidance (no PII):
      • Take screenshots of:
        • App’s Scan Login screen showing black preview (ensure no user identifiers are visible; do not capture real QR content).
        • System Settings > App > Permissions > Camera screen (mask app/account names if needed).
      • If annotating, redact any sensitive text or images.
    • Notes on privacy:
      • Use a dummy/test QR code.
      • Do not include user accounts, tokens, or real content in logs or screenshots.
      • Share logs/screenshots only through approved channels.
  • Technical references:

示例详情

📖 如何使用

30秒出活:复制 → 粘贴 → 搞定
与其花几十分钟和AI聊天、试错,不如直接复制这些经过千人验证的模板,修改几个 {{变量}} 就能立刻获得专业级输出。省下来的时间,足够你轻松享受两杯咖啡!
加载中...
💬 不会填参数?让 AI 反过来问你
不确定变量该填什么?一键转为对话模式,AI 会像资深顾问一样逐步引导你,问几个问题就能自动生成完美匹配你需求的定制结果。零门槛,开口就行。
转为对话模式
🚀 告别复制粘贴,Chat 里直接调用
无需切换,输入 / 唤醒 8000+ 专家级提示词。 插件将全站提示词库深度集成于 Chat 输入框。基于当前对话语境,系统智能推荐最契合的 Prompt 并自动完成参数化,让海量资源触手可及,从此彻底告别"手动搬运"。
即将推出
🔌 接口一调,提示词自己会进化
手动跑一次还行,跑一百次呢?通过 API 接口动态注入变量,接入批量评价引擎,让程序自动迭代出更高质量的提示词方案。Prompt 会自己进化,你只管收结果。
发布 API
🤖 一键变成你的专属 Agent 应用
不想每次都配参数?把这条提示词直接发布成独立 Agent,内嵌图片生成、参数优化等工具,分享链接就能用。给团队或客户一个"开箱即用"的完整方案。
创建 Agent

✅ 特性总结

一键生成贴合场景的安卓错误提示,兼顾排查效率与用户理解与操作体验
自动识别错误级别,匹配合适语气与展示方式,避免惊吓用户又不淡化风险
内置解决步骤与后续指引,直接可用,减少重复沟通与来回确认成本
覆盖开发调试、用户支持、测试验证等场景,输出统一风格,易维护易扩展
可定制标题、详情、影响范围等结构,沉淀团队规范,降低跨端协作摩擦
按目标用户切换表达深浅,工程师看得准,普通用户也能快速看懂并行动
自动补充影响范围与行动建议,帮助定位问题,降低流失与投诉率
支持多语言输出与语气切换,国际版本保持一致体验与沟通效率
预留资料与帮助链接位,指向文档或工单渠道,提升自助解决比例

🎯 解决的问题

为安卓团队提供一套即插即用的“错误消息生成与规范化”能力,帮助开发、测试、运营与客服快速产出同时兼顾准确性与可读性的提示信息。在开发调试、用户交互、系统异常、测试验证等场景下,一键生成“准确+好懂+可执行”的错误提示:

  • 降低用户流失与差评,提升留存、转化与商店评分
  • 显著缩短问题定位与修复周期,减少反复沟通与返工
  • 统一跨团队口径与风格,沉淀可复用规范与组件
  • 支持多语言输出与不同严重级别适配,减少出海与本地化成本
  • 在保障不暴露敏感信息的前提下,给出明确解决路径与后续指引

🕒 版本历史

当前版本
v2.1 2024-01-15
优化输出结构,增强情节连贯性
  • ✨ 新增章节节奏控制参数
  • 🔧 优化人物关系描述逻辑
  • 📝 改进主题深化引导语
  • 🎯 增强情节转折点设计
v2.0 2023-12-20
重构提示词架构,提升生成质量
  • 🚀 全新的提示词结构设计
  • 📊 增加输出格式化选项
  • 💡 优化角色塑造引导
v1.5 2023-11-10
修复已知问题,提升稳定性
  • 🐛 修复长文本处理bug
  • ⚡ 提升响应速度
v1.0 2023-10-01
首次发布
  • 🎉 初始版本上线
COMING SOON
版本历史追踪,即将启航
记录每一次提示词的进化与升级,敬请期待。

💬 用户评价

4.8
⭐⭐⭐⭐⭐
基于 28 条评价
5星
85%
4星
12%
3星
3%
👤
电商运营 - 张先生
⭐⭐⭐⭐⭐ 2025-01-15
双十一用这个提示词生成了20多张海报,效果非常好!点击率提升了35%,节省了大量设计时间。参数调整很灵活,能快速适配不同节日。
效果好 节省时间
👤
品牌设计师 - 李女士
⭐⭐⭐⭐⭐ 2025-01-10
作为设计师,这个提示词帮我快速生成创意方向,大大提升了工作效率。生成的海报氛围感很强,稍作调整就能直接使用。
创意好 专业
COMING SOON
用户评价与反馈系统,即将上线
倾听真实反馈,在这里留下您的使用心得,敬请期待。
加载中...