Linux下adb调试小米手机报错Exception的5种解决方法（附详细排查步骤）

Linux下adb调试小米手机报错Exception的5种深度解决方案最近在Linux环境下用adb调试小米手机时不少开发者遇到了Exception occurred while executing put这个让人头疼的错误。作为一名常年与adb打交道的开发者我深知这种问题一旦出现轻则打断工作流程重则影响整个开发进度。今天我们就来彻底剖析这个问题的根源并提供五种经过实战验证的解决方案。1. 理解错误本质与初步排查这个错误的核心是权限问题。当adb尝试向系统设置写入数据时小米手机的安全机制阻止了这一操作。错误信息中通常还包含java.lang.SecurityException这进一步确认了权限不足的事实。首先我们需要确认几个基本条件是否满足手机已开启开发者模式连续点击MIUI版本号7次USB调试选项已启用电脑已正确识别设备可通过lsusb命令检查使用原装数据线或确认数据线支持数据传输提示小米手机在MIUI 12及更高版本中加强了权限控制这是导致该问题频发的主要原因之一。执行以下命令检查设备连接状态adb devices正常情况应显示设备序列号及device状态。如果显示unauthorized需要在手机上确认USB调试授权。2. 解决方案一启用USB调试安全设置小米手机有一个隐藏但关键的设置项——USB调试安全设置。这个选项默认关闭导致adb的部分操作被系统拒绝。操作步骤进入手机设置 → 关于手机连续点击MIUI版本7次开启开发者选项返回设置 → 更多设置 → 开发者选项找到并启用USB调试安全设置重新连接USB线并确认授权这个方案看似简单但根据我的经验能解决约40%的类似问题。特别是在MIUI 12.5及以上版本中这个设置项变得更加重要。3. 解决方案二调整adb shell权限级别当基础权限设置无效时我们需要提升adb shell的权限级别。小米手机对settings命令的访问有严格限制。分步操作连接手机并确保adb devices显示正常执行以下命令获取shell权限adb shell在shell中提升至root权限需要手机已rootsu授予adb必要的权限pm grant com.android.shell android.permission.WRITE_SECURE_SETTINGS退出shell并重启adb服务exit adb kill-server adb start-server如果手机未root可以尝试以下替代方案adb shell appops set com.android.shell WRITE_SECURE_SETTINGS allow4. 解决方案三配置udev规则解决设备识别问题Linux系统下设备识别问题经常导致adb异常。为小米手机创建专用的udev规则可以显著提高连接稳定性。详细配置流程首先获取设备厂商IDlsusb在输出中找到小米设备记录ID如2717:ff48创建udev规则文件sudo nano /etc/udev/rules.d/51-android.rules添加以下内容替换为你设备的IDSUBSYSTEMusb, ATTR{idVendor}2717, MODE0666, GROUPplugdev保存后应用规则并重启服务sudo udevadm control --reload-rules sudo service udev restart重新插拔设备并检查权限ls -l /dev/bus/usb/*下表列出了常见手机品牌的厂商ID品牌厂商ID小米2717OPPO22d9Vivo2d95华为12d15. 解决方案四使用特定adb版本与驱动组合adb工具的版本兼容性也是一个常见痛点。经过多次测试我发现以下组合在小米手机上最为稳定首先卸载现有adb工具sudo apt remove android-tools-adb android-tools-fastboot安装特定版本adbwget https://dl.google.com/android/repository/platform-tools-latest-linux.zip unzip platform-tools-latest-linux.zip sudo cp platform-tools/adb /usr/bin/adb sudo cp platform-tools/fastboot /usr/bin/fastboot设置正确的用户组权限sudo groupadd plugdev sudo usermod -aG plugdev $USER sudo chmod arx /usr/bin/adb验证版本adb version推荐使用版本32.0.0及以上6. 解决方案五深度配置MIUI开发者选项当上述方法都无效时我们需要对MIUI系统进行更深层次的配置。这些设置项分散在不同的菜单中需要仔细检查。关键设置检查清单开发者选项 → 启用USB调试开发者选项 → 启用USB安装开发者选项 → 启用USB调试安全设置开发者选项 → 关闭MIUI优化临时更多设置 → 权限管理 → 自动启动管理 → 允许adb相关服务自启应用管理 → 显示所有应用 → Android系统 → 权限 → 开启所有相关权限完成这些设置后建议执行以下adb命令序列adb kill-server sudo $(which adb) start-server adb devices adb shell settings put global adb_enabled 17. 高级排查与日志分析技巧当问题仍然存在时我们需要深入系统日志寻找线索。以下是我总结的高效排查方法启用详细日志adb logcat -v time adb_log.txt同时监控内核消息dmesg -wH dmesg.log关键日志过滤技巧adb logcat | grep -E Exception|Security|adb|permission检查selinux状态adb shell getenforce如果是Enforcing状态尝试临时设置为Permissiveadb shell setenforce 0常见错误模式与对应解决方案错误日志片段可能原因解决方案SecurityException: Permission缺少WRITE_SECURE_SETTINGS使用方案二的权限授予命令Session -1 not foundadb会话失效重启adb服务与手机USB调试Device not authorized未授权调试重新插拔并确认授权对话框No such file or directoryudev规则缺失应用方案三的udev配置8. 自动化脚本与长期解决方案为了彻底解决这个问题我开发了一个自动化配置脚本可以一键完成大部分设置#!/bin/bash # 小米adb自动配置脚本 echo [1] 检查adb设备... if ! adb devices | grep -q device$; then echo 未找到已授权设备请检查连接 exit 1 fi echo [2] 设置必要权限... adb shell pm grant com.android.shell android.permission.WRITE_SECURE_SETTINGS 2/dev/null adb shell appops set com.android.shell WRITE_SECURE_SETTINGS allow 2/dev/null echo [3] 配置全局adb设置... adb shell settings put global adb_enabled 1 adb shell settings put secure install_non_market_apps 1 echo [4] 重启adb服务... adb kill-server sudo $(which adb) start-server echo [5] 验证修复结果... adb shell getprop ro.product.model /dev/null echo 修复成功 || echo 仍需手动检查保存为fix_xiaomi_adb.sh并赋予执行权限后每次遇到问题只需运行chmod x fix_xiaomi_adb.sh ./fix_xiaomi_adb.sh9. 不同MIUI版本的注意事项小米手机的MIUI版本差异会导致adb行为变化这是很多开发者忽略的关键点。根据我的测试记录MIUI 12-12.5需要特别注意USB调试安全设置MIUI 13增加了额外的网络adb认证步骤MIUI 14对put操作的限制最为严格建议关闭增强型保护模式HyperOS需要单独启用开发者模式扩展功能针对MIUI 14及以上版本额外需要执行adb shell setprop persist.security.adbinput.enabled 1 adb reboot10. 无线调试的替代方案如果USB连接问题始终无法解决可以考虑使用无线adb调试。这种方法绕过了部分USB权限限制在手机上启用无线调试adb tcpip 5555查找手机IP地址adb shell ip addr show wlan0 | grep inet 电脑端连接adb connect 手机IP:5555验证连接adb devices无线调试时建议配合以下命令保持连接稳定adb shell settings put global adb_wifi_enabled 1 adb shell settings put global adb_wifi_qr_code