摘要：本文从零开始，手把手带你实现一套完整的 Android 短信收发模块。内容涵盖开发环境搭建与权限配置、短信列表界面设计、读取手机短信数据、新建发送界面交互、调用系统 API 发送短信、监听并处理收到短信的回复机制，以及完整流程联调与真机测试验证。同时，针对常见权限报错、运行时异常排查、不同 Android 版本的兼容性适配等痛点给出可落地的解决方案，并分享项目优化方向与安全隐私注意事项，帮助新手开发者避开过时教程的陷阱，快速跑通短信功能并适配当前主流开发环境。关键词：Android；短信收发；权限配置；BroadcastReceiver；SmsManager；ContentProvider；运行时权限；真机测试；兼容性适配目录① 开发环境搭建与权限配置要点② 短信列表界面布局设计与实现③ 读取手机短信数据的代码逻辑④ 新建短信发送界面的交互设计⑤ 调用系统 API 实现短信发送功能⑥ 监听并处理收到短信的回复机制⑦ 完整流程联调与真机测试验证⑧ 常见权限报错与运行时异常排查⑨ 不同 Android 版本的兼容性适配技巧⑩ 项目优化方向与安全隐私注意事项⑪ 实战代码：完整短信收发模块在移动应用开发中，短信功能往往是被低估却又不可或缺的一环。无论是用于用户身份验证、订单通知，还是构建简易的内部通讯工具，直接调用系统原生短信能力都能带来最稳定的体验。然而，许多开发者在着手实现时，往往会卡在权限申请的繁琐流程上，或者在处理不同 Android 版本的行为差异时感到头疼。特别是随着系统安全策略的收紧，过去简单的配置方式已不再适用，稍有不慎就会导致应用在真机上崩溃或功能失效。这篇文章将基于实际的开发场景，从零开始梳理一套完整的短信模块实现方案。我们不会只停留在理论层面，而是会深入代码细节，探讨如何优雅地处理权限请求、如何设计符合用户习惯的交互界面，以及如何应对接收短信时的后台监听逻辑。如果你正在为一个项目添加短信收发功能，或者想要重构现有的老旧代码以适配新系统，那么接下来的内容将提供可直接落地的参考路径。我们将避开那些过时的教程陷阱，专注于当前主流开发环境下的最佳实践，确保你的应用既能跑通流程，又能经得起真机测试的考验。① 开发环境搭建与权限配置要点启动任何涉及系统底层能力的功能前，环境的正确配置是基石。在现代 Android 开发中，首先需要在AndroidManifest.xml文件中声明必要的权限。对于短信模块，核心权限主要包括读取短信 (READ_SMS)、发送短信 (SEND_SMS) 以及接收短信 (RECEIVE_SMS)。值得注意的是，从 Android 6.0 (API Level 23) 开始，这些被归类为“危险权限”，仅仅在清单中声明是不够的，必须在运行时动态向用户申请。在AndroidManifest.xml中，我们需要在manifest根节点下添加如下权限声明：uses-permissionandroid:name="android.permission.READ_SMS"/uses-permissionandroid:name="android.permission.SEND_SMS"/uses-permissionandroid:name="android.permission.RECEIVE_SMS"/其中，READ_SMS用于读取短信数据库，SEND_SMS用于应用内静默发送短信，RECEIVE_SMS用于监听新短信广播。如果你的应用只需要唤起系统短信应用来发送，那么SEND_SMS权限可以省略，这能减少权限弹窗对用户的打扰。除了权限声明，依赖库的选择也至关重要。为了简化兼容性处理，建议引入androidx.core库中的ActivityCompat和ContextCompat类，它们能帮助我们以更统一的方式检查和处理权限状态。在build.gradle文件中添加依赖：dependencies { implementation "androidx.core:core-ktx:1.12.0" implementation "androidx.appcompat:appcompat:1.6.1" }运行时权限的申请逻辑通常放在Activity的onCreate方法中，先检查权限是否已授予，未授予则发起请求：if(ContextCompat.checkSelfPermission(this,Manifest.permission.READ_SMS)!=PackageManager.PERMISSION_GRANTED){ActivityCompat.requestPermissions(this,newString[]{Manifest.permission.READ_SMS,Manifest.permission.SEND_SMS,Manifest.permission.RECEIVE_SMS},REQUEST_SMS_PERMISSIONS);}else{// 权限已授予，直接加载短信列表loadSmsList();}同时，若需要监听短信广播，还需注册相应的BroadcastReceiver，并在清单中配置 intent-filter，确保系统能将收到的短信事件投递给我们的应用。在开发初期，务必确认测试设备的系统版本，因为不同版本的默认短信应用行为可能存在差异，这直接影响后续的调试策略。建议在build.gradle中设置minSdkVersion为 23（Android 6.0），以覆盖运行时权限模型，同时将targetSdkVersion提升到较新版本，确保应用遵循最新的系统安全策略。② 短信列表界面布局设计与实现一个友好的短信列表界面是用户体验的第一道门槛。在设计布局时，我们通常采用RecyclerView来展示数据，因为它能高效处理大量列表项的复用与滚动。每个列表项（Item Layout）应包含发件人号码、短信内容摘要、接收时间以及阅读状态标识。为了提升可读性，发件人号码若匹配本地联系人，应尽量显示联系人姓名；若无匹配，则显示号码本身。首先，在activity_main.xml中放置一个RecyclerView作为列表容器：androidx.recyclerview.widget.RecyclerViewandroid:id="@+id/rvSmsList"android:layout_width="match_parent"android:layout_height="match_parent"android:clipToPadding="false"android:paddingBottom="8dp"tools:listitem="@layout/item_sms"/接下来，创建列表项布局item_sms.xml。使用ConstraintLayout来灵活安排各个控件的位置：将发件人信息置于左上角，时间戳置于右上角，内容摘要占据下方主要区域并限制最大行数以避免界面杂乱：androidx.constraintlayout.widget.ConstraintLayoutxmlns:android="http://schemas.android.com/apk/res/android"xmlns:app="http://schemas.android.com/apk/res-auto"android:layout_width="match_parent"android:layout_height="wrap_content"android:padding="12dp"TextViewandroid:id="@+id/tvSender"android:layout_width="0dp"android:layout_height="wrap_content"android:textStyle="bold"android:maxLines="1"android:ellipsize="end"app:layout_constraintStart_toStartOf="parent"app:layout_constraintTop_toTopOf="parent"app:layout_constraintEnd_toStartOf="@id/tvTime"/TextViewandroid:id="@+id/tvTime"android:layout_width="wrap_content"android:layout_height="wrap_content"android:textSize="12sp"android:textColor="#999999"app:layout_constraintEnd_toEndOf="parent"app:layout_constraintTop_toTopOf="parent"/TextViewandroid:id="@+id/tvContent"android:layout_width="0dp"android:layout_height="wrap_content"android:maxLines="2"android:ellipsize="end"android:textColor="#666666"app:layout_constraintStart_toStartOf="parent"app:layout_constraintTop_toBottomOf="@id/tvSender"app:layout_constraintEnd_toEndOf="parent"/Viewandroid:id="@+id/viewUnreadDot"android:layout_width="8dp"android:layout_height="8dp"android:background="@drawable/bg_unread_dot"android:visibility="gone"app:layout_constraintStart_toStartOf="parent"app:layout_constraintTop_toTopOf="parent"//androidx.constraintlayout.widget.ConstraintLayout针对未读短信，可以通过改变背景色或添加醒目的标记点来提示用户。上面的布局中预留了一个viewUnreadDot小圆点，配合一个简单的 drawable 即可实现：!-- res/drawable/bg_unread_dot.xml --shapexmlns:android="http://schemas.android.com/apk/res/android"android:shape="oval"solidandroid:color="#FF5252"/sizeandroid:width="8dp"android:height="8dp"//shape在 Adapter 的实现中，需注意数据绑定的逻辑，确保当数据源更新时，界面能实时刷新。对于长短信的处理，建议在 UI 层做截断显示，并提供点击展开详情的交互，保持列表的整洁性。核心 Adapter 代码如下：publicclassSmsAdapterextendsRecyclerView.AdapterSmsAdapter.SmsViewHolder{privatefinalListSmsMessagedata=newArrayList();publicvoidsubmitList(ListSmsMessagenewList){data.clear();data.addAll(newList);notifyDataSetChanged();}@NonNull@OverridepublicSmsViewHolderonCreateViewHolder(@NonNullViewGroupparent,intviewType){Viewview=LayoutInflater.from(parent.getContext()).inflate(R.layout.item_sms,parent,false);returnnewSmsViewHolder(view);}@OverridepublicvoidonBindViewHolder(@NonNullSmsViewHolderholder,intposition){SmsMessagesms=data.get(position);holder.tvSender.setText(sms.address);holder.tvTime.setText(formatTime(sms.date));holder.tvContent.setText(sms.body);// 未读标记：这里以 type 字段简单示意，实际可按业务状态判断booleanunread=sms.type==1;holder.viewUnreadDot.setVisibility(unread?View.VISIBLE:View.GONE);}@OverridepublicintgetItemCount(){returndata.size();}privateStringformatTime(longtimestamp){SimpleDateFormatsdf=newSimpleDateFormat("MM-dd HH:mm",Locale.getDefault());returnsdf.format(newDate(timestamp));}staticclassSmsViewHolderextendsRecyclerView.ViewHolder{TextViewtvSender,tvTime,tvContent;ViewviewUnreadDot;SmsViewHolder(@NonNullViewitemView){super(itemView);tvSender=itemView.findViewById(R.id.tvSender);tvTime=itemView.findViewById(R.id.tvTime);tvContent=itemView.findViewById(R.id.tvContent);viewUnreadDot=itemView.findViewById(R.id.viewUnreadDot);}}}最后，在Activity中完成RecyclerView的初始化与数据绑定：RecyclerViewrvSmsList=findViewById(R.id.rvSmsList);rvSmsList.setLayoutManager(newLinearLayoutManager(this));SmsAdapteradapter=newSmsAdapter();rvSmsList.setAdapter(adapter);// 数据加载完成后调用adapter.submitList(smsList);这样，一个结构清晰、可复用的短信列表界面就搭建完成了。后续如需增加点击展开详情、长按删除等交互，只需在SmsViewHolder中为itemView绑定相应监听即可。③ 读取手机短信数据的代码逻辑获取短信数据的核心在于查询系统提供的 ContentProvider。Android 系统将所有短信存储在content://sms/_uri_下，我们可以通过ContentResolver进行查询。代码逻辑上，首先构建一个查询投影（Projection），指定需要获取的字段，如地址 (address)、内容 (body)、日期 (date) 和类型 (type)。publicListSmsMessageloadSmsMessages(Contextcontext){ListSmsMessagesmsList=newArrayList();Uriuri=Uri.parse("content://sms/inbox");String[]projection=newString[]{"address","body","date","type"};// 按日期降序排列，确保最新短信在前StringsortOrder="date DESC";Cursorcursor=context.getContentResolver().query(uri,projection,null,null,sortOrder);if(cursor!=null){while(cursor.moveToNext()){Stringaddress=cursor.getString(cursor.getColumnIndexOrThrow("address"));Stringbody=cursor.getString(cursor.getColumnIndexOrThrow("body"));longdate=cursor.getLong(cursor.getColumnIndexOrThrow("date"));inttype=cursor.getInt(cursor.getColumnIndexOrThrow("type"));smsList.add(newSmsMessage(address,body,date,type));}cursor.close();}returnsmsList;}这段代码展示了基本的查询流程。需要注意的是，Cursor对象使用完毕后必须关闭，以防内存泄漏。另外，查询操作属于 I/O 密集型任务，严禁在主线程中执行，否则会导致 ANR（应用无响应）。应当将其放入协程或异步线程中运行，待数据加载完成后，再通过回调或 LiveData 通知 UI 层进行更新。下面给出一个基于ExecutorService的异步加载示例，避免阻塞主线程：publicvoidloadSmsAsync(Contextcontext,SmsLoadCallbackcallback){ExecutorServiceexecutor=Executors.newSingleThreadExecutor();executor.execute(()-{ListSmsMessageresult=loadSmsMessages(context);newHandler(Looper.getMainLooper()).post(()-callback.onLoaded(result));});executor.shutdown();}publicinterfaceSmsLoadCallback{voidonLoaded(ListSmsMessagesmsList);}对于不同类型的短信（如收件箱、已发送、草稿箱），只需修改 URI 路径即可实现分类读取。常用的 URI 对应关系如下：短信类型URI 路径说明收件箱content://sms/inbox收到的短信已发送content://sms/sent已发送的短信草稿箱content://sms/draft未发送的草稿全部content://sms/all所有短信（含收件、发送、草稿等）此外，type字段也对应着固定的枚举值：1表示收件箱、2表示已发送、3表示草稿箱、4表示已发出、5表示失败、6表示队列中。在业务层可以根据type值做更精细的过滤与展示，例如只展示收件箱中未读的短信，或统计某段时间内的发送失败记录。④ 新建短信发送界面的交互设计发送短信的界面设计应遵循“极简”原则，减少用户的操作步骤。标准界面通常包含三个核心元素：收件人输入框、短信内容编辑区以及发送按钮。收件人输入框最好支持自动补全功能，能够读取本地联系人列表，让用户通过输入姓名或号码片段快速定位目标。在交互细节上，内容编辑区应具备字数统计功能，实时显示当前输入字符数及剩余可用字数（通常单条短信限制为 160 个英文字符或 70 个中文字符），当超出限制时提示用户短信将被拆分计费。发送按钮在内容为空时应处于禁用状态，防止误触。此外，考虑到用户可能需要进行群发，界面还应支持添加多个收件人，并以标签（Chip）的形式展示在输入框上方，允许用户随时移除某个特定收件人。键盘弹出时，界面应自动调整布局，确保发送按钮始终可见且易于点击。下面给出一个简洁的发送界面布局示例，使用LinearLayout纵向排列，配合TextInputLayout提升输入体验：LinearLayoutxmlns:android="http://schemas.android.com/apk/res/android"android:layout_width="match_parent"android:layout_height="match_parent"android:orientation="vertical"android:padding="16dp"!-- 收件人输入框，支持自动补全 --com.google.android.material.textfield.TextInputLayoutandroid:id="@+id/tilRecipient"android:layout_width="match_parent"android:layout_height="wrap_content"android:hint="收件人"AutoCompleteTextViewandroid:id="@+id/etRecipient"android:layout_width="match_parent"android:layout_height="wrap_content"android:inputType="phone"android:maxLines="1"//com.google.android.material.textfield.TextInputLayout!-- 短信内容编辑区 --com.google.android.material.textfield.TextInputLayoutandroid:id="@+id/tilContent"android:layout_width="match_parent"android:layout_height="0dp"android:layout_weight="1"android:layout_marginTop="12dp"android:hint="短信内容"EditTextandroid:id="@+id/etContent"android:layout_width="match_parent"android:layout_height="match_parent"android:gravity="top|start"android:inputType="textMultiLine"android:maxLength="500"//com.google.android.material.textfield.TextInputLayout!-- 字数统计与发送按钮 --LinearLayoutandroid:layout_width="match_parent"android:layout_height="wrap_content"android:layout_marginTop="8dp"android:gravity=