身份证验证工具 | KMP鸿蒙Kotlin号码识别

本文介绍了在Kotlin Multiplatform项目中实现身份证验证工具的核心功能。通过Kotlin代码实现身份证号码的长度验证、地区信息提取、出生日期解析、日期合法性检查、性别识别以及校验位验证等功能。验证工具能够处理15位和18位身份证号码，提取省份、城市、区县代码，解析出生年份（自动处理15位身份证的年份推断），检查日期格式有效性，识别性别信息，并执行国家标准的校验位验证。最后通过综合评

2501_94510240

961人浏览 · 2025-12-03 21:49:53

2501_94510240 · 2025-12-03 21:49:53 发布

在这里插入图片描述

📚 概述

本案例深入探讨了在 Kotlin Multiplatform (KMP) 项目中实现身份证验证工具的完整流程。通过将 Kotlin 代码编译为 JavaScript，并在 OpenHarmony 的 ArkTS 中调用，我们展示了如何充分利用 Kotlin 的特性来进行号码识别、数据验证和信息提取。

身份证验证是现代应用开发的重要功能，允许我们验证用户身份、提取个人信息、确保数据安全。在 KMP 项目中，我们可以利用这些特性来构建具有强大验证能力的应用。

本文将详细介绍如何在 KMP 项目中实现身份证号码验证、信息提取、格式检查等核心概念。

🎯 核心概念

1. 号码长度验证 (Length Validation)

验证身份证号码的长度。

// 验证长度
val isValid18Digit = cleanId.length == 18
val isValid15Digit = cleanId.length == 15

if (!isValid18Digit && !isValid15Digit) {
    return "❌ 错误: 身份证号码长度不正确（应为15或18位）"
}

代码解释：

检查身份证号码是否为18位（新版）或15位（旧版）
如果长度不符合要求，返回错误信息
这是验证的第一步，确保基本格式正确

2. 地区信息提取 (Region Information Extraction)

从身份证号码中提取地区代码。

// 提取信息
val province = cleanId.substring(0, 2)
val city = cleanId.substring(2, 4)
val district = cleanId.substring(4, 6)

代码解释：

第1-2位：省份代码
第3-4位：城市代码
第5-6位：区县代码
这些代码遵循国家标准编码规范

3. 出生日期提取 (Birth Date Extraction)

从身份证号码中提取出生日期。

// 提取出生日期
val birthYear = if (isValid18Digit) {
    cleanId.substring(6, 10)
} else {
    val year = cleanId.substring(6, 8).toInt()
    if (year > 50) "19$year" else "20$year"
}

val birthMonth = cleanId.substring(if (isValid18Digit) 10 else 8, if (isValid18Digit) 12 else 10)
val birthDay = cleanId.substring(if (isValid18Digit) 12 else 10, if (isValid18Digit) 14 else 12)

代码解释：

18位身份证：第7-10位为年份、第11-12位为月份、第13-14位为日期
15位身份证：第7-8位为年份、第9-10位为月份、第11-12位为日期
15位身份证的年份需要推断世纪（>50为19xx，≤50为20xx）

4. 日期合法性验证 (Date Validity Validation)

验证提取的日期是否合法。

// 验证日期合法性
val monthInt = birthMonth.toIntOrNull() ?: 0
val dayInt = birthDay.toIntOrNull() ?: 0

val dateValid = monthInt in 1..12 && dayInt in 1..31

代码解释：

月份必须在1-12之间
日期必须在1-31之间
这是基本的日期范围检查

5. 性别识别 (Gender Identification)

从身份证号码中识别性别。

// 提取性别（倒数第二位：奇数为男，偶数为女）
val genderCode = if (isValid18Digit) {
    cleanId.substring(16, 17).toIntOrNull() ?: 0
} else {
    cleanId.substring(14, 15).toIntOrNull() ?: 0
}
val gender = if (genderCode % 2 == 1) "男" else "女"

代码解释：

18位身份证：第17位为性别代码
15位身份证：第15位为性别代码
奇数表示男性，偶数表示女性
这是身份证编码的标准规范

6. 校验位验证 (Checksum Validation)

验证18位身份证的校验位。

private fun validateChecksum(id: String): Boolean {
    if (id.length != 18) return false
    
    val weights = intArrayOf(7, 9, 10, 5, 8, 4, 2, 1, 6, 3, 7, 9, 10, 5, 8, 4, 2)
    val checkCodes = charArrayOf('1', '0', 'X', '9', '8', '7', '6', '5', '4', '3', '2')
    
    var sum = 0
    for (i in 0 until 17) {
        val digit = id[i].toString().toIntOrNull() ?: return false
        sum += digit * weights[i]
    }
    
    val checkIndex = sum % 11
    return id[17] == checkCodes[checkIndex]
}

代码解释：

前17位数字分别乘以对应的权重系数
将乘积相加得到总和
总和模11得到检验码索引
第18位应该与检验码对应的字符相同
这是国家标准的校验算法

7. 综合评分计算 (Score Calculation)

计算验证的综合评分。

private fun calculateScore(isValid: Boolean, dateValid: Boolean, checksumValid: Boolean): Int {
    var score = 0
    if (isValid) score += 40
    if (dateValid) score += 30
    if (checksumValid) score += 30
    return score
}

代码解释：

格式正确：40分
日期有效：30分
校验位有效：30分
总分100分，≥80分为通过

💡 实现代码详解

Kotlin 源代码

fun idCardValidationTool(idNumber: String): String {
    return try {
        val result = mutableListOf<String>()
        val cleanId = idNumber.trim().uppercase()
        
        // 第一步：检查输入是否为空
        if (cleanId.isEmpty()) {
            return "❌ 错误: 请输入身份证号码"
        }
        
        // 第二步：验证号码长度
        val isValid18Digit = cleanId.length == 18
        val isValid15Digit = cleanId.length == 15
        
        if (!isValid18Digit && !isValid15Digit) {
            return "❌ 错误: 身份证号码长度不正确（应为15或18位）"
        }
        
        // 第三步：提取地区信息
        val province = cleanId.substring(0, 2)
        val city = cleanId.substring(2, 4)
        val district = cleanId.substring(4, 6)
        
        // 第四步：提取出生日期
        val birthYear = if (isValid18Digit) {
            cleanId.substring(6, 10)
        } else {
            val year = cleanId.substring(6, 8).toInt()
            if (year > 50) "19$year" else "20$year"
        }
        
        val birthMonth = cleanId.substring(if (isValid18Digit) 10 else 8, if (isValid18Digit) 12 else 10)
        val birthDay = cleanId.substring(if (isValid18Digit) 12 else 10, if (isValid18Digit) 14 else 12)
        
        // 第五步：验证日期合法性
        val monthInt = birthMonth.toIntOrNull() ?: 0
        val dayInt = birthDay.toIntOrNull() ?: 0
        val dateValid = monthInt in 1..12 && dayInt in 1..31
        
        // 第六步：提取性别信息
        val genderCode = if (isValid18Digit) {
            cleanId.substring(16, 17).toIntOrNull() ?: 0
        } else {
            cleanId.substring(14, 15).toIntOrNull() ?: 0
        }
        val gender = if (genderCode % 2 == 1) "男" else "女"
        
        // 第七步：验证校验位
        val checksumValid = if (isValid18Digit) {
            validateChecksum(cleanId)
        } else {
            true
        }
        
        // 第八步：构建验证结果
        result.add("✅ 身份证验证结果")
        result.add("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━")
        result.add("")
        result.add("📋 基本信息:")
        result.add("号码长度: ${cleanId.length} 位")
        result.add("格式状态: ${if (isValid18Digit || isValid15Digit) "✓ 正确" else "✗ 错误"}")
        
        // 继续添加其他信息...
        
        result.joinToString("\n")
    } catch (e: Exception) {
        "❌ 验证失败: ${e.message}"
    }
}

ArkTS 调用代码

import { idCardValidationTool } from './hellokjs'

@Entry
@Component
struct Index {
  @State inputData: string = "110101199003071234"
  @State result: string = ""
  @State isLoading: boolean = false
  
  build() {
    Column() {
      // ... UI 布局代码 ...
    }
  }
  
  executeDemo() {
    this.isLoading = true
    
    setTimeout(() => {
      try {
        this.result = idCardValidationTool(this.inputData)
      } catch (e) {
        this.result = "❌ 执行失败: " + e.message
      }
      this.isLoading = false
    }, 100)
  }
}