如何在 Kotlin 中安全调用 Java 方法并处理潜在空值

Kotlin 与 Java 互操作时，Java 方法返回的引用类型默认被视为平台类型（Platform Type），编译器无法保证其非空性；必须显式按可空类型处理，结合 ?.、?:、if (x != null) 等安全操作符进行防御性编程。

kotlin 与 java 互操作时，java 方法返回的引用类型默认被视为平台类型（platform type），编译器无法保证其非空性；必须显式按可空类型处理，结合 `?.`、`?:`、`if (x != null)` 等安全操作符进行防御性编程。

在 Kotlin 中调用 Java 库时，null 安全并非自动获得——Java 缺乏内置的空标记系统，因此 Kotlin 将所有未标注 @Nullable 或 @NonNull 的 Java 引用类型推断为平台类型（如 String!），既不强制检查也不自动保护。这意味着看似“安全”的代码可能在运行时触发 NullPointerException。

✅ 正确做法：始终以可空类型对待未明确声明非空的 Java 返回值

• 若 Java 方法签名是 String getName()（无注解），Kotlin 中应视作 String? 处理：

  val name: String? = javaObject.getName()val displayName = name?.uppercase() ?: "UNKNOWN"

• 使用安全调用（?.）避免链式调用崩溃：

  val length = javaObject.getAddress()?.getCity()?.length ?: 0

• 使用安全转换或默认值：

  val description = javaObject.getDescription()?.ifEmpty { "No description" } ?: "N/A"

⚠️ 特别注意 Java 的装箱类型与原始类型区别

• Boolean、Integer、Long 等包装类在 Java 中可为 null，对应 Kotlin 的 Boolean?、Int? 等；而 boolean、int、long 等原始类型绝不会为 null，Kotlin 映射为非空基本类型（Boolean、Int、Long）。
• 示例对比：

  // Javapublic Boolean getFlag() { return null; }     // → Kotlin: Boolean?public boolean isReady() { return true; }      // → Kotlin: Boolean (non-nullable)

? 提升安全性：借助注解与工具

• 优先选用已添加 @Nullable / @NonNull（如 JetBrains 或 AndroidX 注解）的 Java 库，Kotlin 能据此推断更精确的可空性；
• 在关键接口处主动添加 @NotNull（需配合 -Xjsr305=strict 编译选项）；
• 对高风险调用，可封装为 Kotlin 扩展函数并内建空检查：

  fun JavaService.safeGetName(): String = getName() ?: "default"

总之，面对 Java 互操作，“假设可空，显式防护”是唯一安全范式——不依赖侥幸，不滥用 !!，不忽略文档说明。唯有将每个 Java 引用视为潜在 null 并使用 Kotlin 的空安全语法严谨处理，才能真正发挥其类型系统的优势。