在进行 Android 埋点调试时，如果执行了 adb shell setprop 命令但在 Firebase 控制台的 DebugView 中看不到实时事件，请按照本手册进行系统性排查。
一、 核心操作流程（标准动作）
执行完命令后，必须 强杀并重启 App，否则 SDK 不会读取最新的系统属性。
1.设置调试包名：
adb shell setprop debug.firebase.analytics.app<你的包名>2.开启详细日志 (Verbose)：
adb shell setprop log.tag.FA VERBOSE adb shell setprop log.tag.FA-SVC VERBOSE3.强制停止应用（关键）：
adb shell am force-stop<你的包名>4.重新启动应用：
手动点击图标启动，或观察 Logcat 输出。二、 重点排查清单
1. 设备时间不准确（隐蔽但致命）
- 问题原因：Firebase 服务器会校验事件的时间戳。如果手机系统时间与实际时间偏差较大（例如手动调慢了 1 小时），Firebase 后台会认为数据异常而直接丢弃。
- 解决方案：进入手机设置 -> 系统 -> 日期和时间，开启“自动确定时间/使用网络提供的时间”。
2. 属性生效规则
- 内存驻留：通过
setprop设置的属性保存在系统内存中。只要手机不关机重启，设置就会一直生效。 - 覆盖逻辑：重复设置多次同一包名无负面影响；设置新包名会覆盖旧包名。
- 检查方法：执行以下命令确认当前设置的值：
adb shell getprop debug.firebase.analytics.app
3. 日志级别初始化机制
- 原理说明：Android 的日志标签级别（Log Tag Level）通常仅在类加载或SDK 初始化时读取。
- 生效条件：如果在 App 运行过程中执行了
log.tag.FA VERBOSE，必须强杀进程并重启，Firebase SDK 才会重新检查该属性并输出 Verbose 级别的详细日志。
4. Logcat 观察技巧
- 过滤器设置：在 Android Studio 的 Logcat 中，确保级别选为Verbose，过滤器选为“No Filters”（不要只看当前进程，因为
FA-SVC日志来自 Google Play Services 进程）。 - 关键词搜索：搜索
FA或FA-SVC。- 看到
Logging event：说明代码触发成功。 - 看到
Uploading data：说明手机正在向服务器上报。
- 看到
三、 快速重置步骤（大招）
如果 DebugView 依然收不到最新事件，请尝试“彻底重置法”：
- 清除当前调试状态：
adb shell setprop debug.firebase.analytics.app .none. - 稍微等待几秒后重新设置：
adb shell setprop debug.firebase.analytics.app<你的包名> - 重新注入日志开关：
adb shell setprop log.tag.FA VERBOSE adb shell setprop log.tag.FA-SVC VERBOSE - 强制重启应用：
adb shell am force-stop<你的包名>
四、 总结提示
- 只要不关机，属性一直有：无需每次连接电脑都重新设置，除非手机重启过。
- 重启 App 是第一准则：无论是修改了包名还是开启了日志，强杀进程是让配置生效的唯一可靠手段。
- 后台数据 vs DebugView：如果后台“实时”模块有数据但 DebugView 没数据，重点检查
setprop包名是否拼写正确以及浏览器页面是否需要刷新。 - 开启详细日志 (Verbose)：不是必须的，为了看本地是否上传埋点， 在模拟器上使用FA过滤日志
