Android Kotlin邮件发送失败求助：Transport.send处崩溃

核心崩溃原因 #

• 主线程网络限制：Android从API 11开始禁止在UI线程（主线程）执行网络操作，Transport.send()本质是网络请求，按钮点击事件默认在主线程执行，直接调用会触发NetworkOnMainThreadException导致崩溃。而单独运行Kotlin main函数是在普通JVM环境，无此限制。
• 缺少网络权限：未在AndroidManifest.xml中声明网络权限，系统会拦截网络请求，引发权限相关异常。
• 邮箱配置错误：
  • 第三方邮箱（如Gmail）开启两步验证后，需使用应用专用密码替代原密码；
  • 部分邮箱默认禁用SMTP服务，需在邮箱后台开启；
  • SMTP服务器地址、端口配置错误（例如Gmail的SMTP地址为smtp.gmail.com，端口为587或465）。
• 未捕获异常：代码未对Transport.send()的异常做处理，崩溃时无法获取具体错误信息，难以定位问题。

具体解决步骤 #

1. 移至后台线程执行邮件发送
   Android不允许主线程做网络操作，需将邮件逻辑放到IO线程，推荐用Kotlin协程实现：

   fun sendMail() {
       lifecycleScope.launch(Dispatchers.IO) {
           try {
               // 你的邮件构建与发送代码
               Transport.send(message)
               // 发送成功后切回主线程更新UI（可选）
               withContext(Dispatchers.Main) {
                   Toast.makeText(this@MainActivity, "邮件发送成功", Toast.LENGTH_SHORT).show()
               }
           } catch (e: Exception) {
               e.printStackTrace() // 查看Logcat获取具体异常
               withContext(Dispatchers.Main) {
                   Toast.makeText(this@MainActivity, "发送失败：${e.message}", Toast.LENGTH_SHORT).show()
               }
           }
       }
   }
   

2. 添加网络权限
   在AndroidManifest.xml的<manifest>标签内添加权限声明：

   <uses-permission android:name="android.permission.INTERNET" />
   

3. 校验邮箱配置

   • 确认SMTP服务器地址、端口、账号密码正确；
   • 若使用Gmail，开启两步验证后生成应用专用密码，或临时开启“不太安全的应用访问”（不推荐长期使用）；
   • 其他邮箱参考官方文档开启SMTP服务。

4. 查看Logcat日志定位问题
   崩溃时打开Android Studio的Logcat面板，搜索崩溃栈信息，根据具体异常（如AuthenticationFailedException表示认证失败）精准修复。

内容的提问来源于stack exchange，提问作者Jouke