安卓错误消息设计专家

幂简官方

42 浏览

2 试用

0 购买

Nov 30, 2025更新

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

错误标题：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 解耦或懒加载；初始化失败时提供可恢复路径与日志上报，避免把不可恢复的迁移错误直接转化为应用级崩溃。
技术参考：
- Room 迁移指南（含 addMigrations、回退策略说明） https://developer.android.com/training/data-storage/room/migrating-db-versions
- 回退策略 API：fallbackToDestructiveMigrationFrom https://developer.android.com/reference/androidx/room/RoomDatabase.Builder#fallbackToDestructiveMigrationFrom(int...)
- 自动迁移（@AutoMigration） https://developer.android.com/training/data-storage/room/auto-migrations
- 迁移测试（MigrationTestHelper） https://developer.android.com/training/data-storage/room/migrating-db-versions#test

错误标题：支払いを完了できませんでした（タイムアウト）
错误详情：通信が不安定なため、支払い処理が時間内に完了しませんでした。モバイルデータからWi‑Fiへの切り替えが発生した可能性があります。この取引は成立しておらず、注文番号は発行されていません。現時点で請求は確定していません（カード明細に一時的な保留が表示される場合がありますが、通常は自動で解消されます）。
影响范围：
- 今回の支払いは成立していません（商品やサービスはまだ手配・反映されません）。
- 再度の支払い実行が必要です。
- 不安定な通信環境で繰り返すと、処理が遅延・重複申込の不安につながる可能性があります。
解决方案：
- ネットワークを確認し、安定した接続（Wi‑Fiに固定する、または電波状況の良い場所）で再試行してください。
- 連続タップはお控えください。[支払う] の結果が表示されるまでお待ちください。
- 取引状況は「注文履歴」で確認できます。未表示の場合は決済は未成立です。
- 繰り返し失敗する、または不明な請求がある場合はサポートへご連絡ください。下記の「日時」と「セッションID」をお伝えいただくと確認がスムーズです。
- 推奨アクション（ボタン）：
  - 主ボタン：再試行
  - 副ボタン：注文履歴を見る
  - テキストボタン：サポートに連絡
コピーできる情報（サポート向け）：
- 日時：{YYYY-MM-DD HH:mm:ss（ローカル時刻）}［コピー］
- セッションID：{SESSION_ID}［コピー］
技术参考：
- Android デバイスのネットワーク状態の監視（Connectivity）：https://developer.android.com/training/monitoring-device-state/connectivity-status?hl=ja
- ConnectivityManager.NetworkCallback（ネットワーク切替の検知）：https://developer.android.com/reference/android/net/ConnectivityManager.NetworkCallback?hl=ja
- Material Design 3 — Dialog（エラー/警告の提示）：https://m3.material.io/components/dialogs/overview
- Material Design 3 — Snackbar（軽微な通知/再試行）：https://m3.material.io/components/snackbar/overview
- Android クリップボード（コピー操作の実装）：https://developer.android.com/guide/topics/text/copy-paste?hl=ja

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:
- Request app permissions (Android): https://developer.android.com/training/permissions/requesting
- CameraX Camera permissions and setup: https://developer.android.com/training/camerax
- Android 14 behavior changes (privacy/permissions): https://developer.android.com/about/versions/14/behavior-changes-all
- Open app settings via intent (for “Open Settings” action): android.provider.Settings.ACTION_APPLICATION_DETAILS_SETTINGS
  - Reference: https://developer.android.com/reference/android/provider/Settings#ACTION_APPLICATION_DETAILS_SETTINGS

解决的问题

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

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

适用用户

安卓开发工程师

在开发调试阶段快速产出可读错误提示；按严重级别生成不同文案；补充解决步骤与影响范围，减少返工。

测试/QA工程师

复现实例后，一键生成标准化错误消息；将问题描述、影响与复测建议打包给研发；缩短缺陷往返时间。

客服与用户支持团队

把技术异常转译为用户友好的说明与操作步骤；快速识别可自助解决的问题；提升一次解决率与满意度。

特征总结

• 一键生成贴合场景的安卓错误提示，兼顾排查效率与用户理解与操作体验

• 自动识别错误级别，匹配合适语气与展示方式，避免惊吓用户又不淡化风险

• 内置解决步骤与后续指引，直接可用，减少重复沟通与来回确认成本

• 覆盖开发调试、用户支持、测试验证等场景，输出统一风格，易维护易扩展

• 可定制标题、详情、影响范围等结构，沉淀团队规范，降低跨端协作摩擦

• 按目标用户切换表达深浅，工程师看得准，普通用户也能快速看懂并行动

• 自动补充影响范围与行动建议，帮助定位问题，降低流失与投诉率

• 支持多语言输出与语气切换，国际版本保持一致体验与沟通效率

• 预留资料与帮助链接位，指向文档或工单渠道，提升自助解决比例

如何使用购买的提示词模板

1. 直接在外部 Chat 应用中使用

将模板生成的提示词复制粘贴到您常用的 Chat 应用（如 ChatGPT、Claude 等），即可直接对话使用，无需额外开发。适合个人快速体验和轻量使用场景。

2. 发布为 API 接口调用

把提示词模板转化为 API，您的程序可任意修改模板参数，通过接口直接调用，轻松实现自动化与批量处理。适合开发者集成与业务系统嵌入。

3. 在 MCP Client 中配置使用

在 MCP client 中配置对应的 server 地址，让您的 AI 应用自动调用提示词模板。适合高级用户和团队协作，让提示词在不同 AI 工具间无缝衔接。

AI 提示词价格

￥20.00元

先用后买，用好了再付款，超安全！

在线免费用提示词

您购买后可以获得什么

✓

获得完整提示词模板

- 共 523 tokens

- 4 个可调节参数

{ 错误场景 } { 错误级别 } { 目标用户 } { 输出语言 }

✓

获得社区贡献内容的使用权

- 精选社区优质案例，助您快速上手提示词

购买

安卓错误消息设计专家

解决的问题