想要在 Java 项目里快速判断银行卡号格式是否合法,可以直接使用这套带 4 个方法的 Java 工具类,核心依靠 Luhn 校验算法,也就是大家常说的模 10 算法。开发的时候经常需要前端先简单校验、后端再做二次校验,单纯判断长度和数字格式很容易被伪造卡号绕过,Luhn 校验能快速筛掉大量明显错误的卡号,这个工具类拆分了独立方法,分别负责清除空格、判断是否纯数字、Luhn 校验、整合一站式校验,方便大家按需调用,不用自己反复写重复逻辑。
一、工具类 4 个方法功能清单
| 方法名称 | 作用说明 |
|---|---|
| clearBlank(String cardNo) | 清理卡号里的空格、分隔符,把卡号字符串做格式化处理 |
| isAllNumber(String cardNo) | 校验处理后的字符串是否全部为数字,排除字母、符号 |
| checkLuhn(String cardNo) | 核心 Luhn 算法计算校验,返回 true/false,只负责算法规则验证 |
| isValidBankCard(String cardNo) | 一站式整合校验:依次去空格、判断纯数字、长度校验、Luhn 校验 |
二、Luhn 校验简单原理
- 从卡号倒数第二位开始,隔一位数字乘以 2;
- 相乘结果如果大于 9,就把十位和个位相加;
- 所有数字求和,总和对 10 取模,余数等于 0 就代表 Luhn 校验通过。
注意:Luhn 通过 ≠ 卡号真实存在,只是格式合法。
三、使用注意要点清单
- Luhn 校验只能校验卡号格式,不能查询银行卡是否真实开户、状态是否正常
- 国内银行卡长度大多是 16~19 位,工具类里可以自行配置长度范围
- 后端校验是底线,前端校验只做体验优化,不能替代后端
- 卡号属于敏感信息,代码日志里禁止直接打印完整银行卡号
【常见问题】
问题 1:这个带 Luhn 校验的 Java 工具类,Luhn 校验通过就代表银行卡号能用吗?
回答 1:带 Luhn 校验的 Java 工具类只能校验卡号格式,Luhn 校验通过只说明卡号符合算法规则,不代表银行卡号真实存在、账户正常,想要核验卡号有效性需要对接银行官方接口。
问题 2:这个 Java 工具类 4 个方法分别可以单独调用吗?
回答 2:这个 Java 工具类的 4 个方法支持单独调用,如果你只需要清理卡号空格,就调用 clearBlank;只跑算法验证就调用 checkLuhn,也可以直接调用 isValidBankCard 一站式完成全部校验。
问题 3:用这个 Java 工具类做银行卡 Luhn 校验,能区分信用卡和储蓄卡吗?
回答 3:这个 Java 工具类里的 Luhn 校验本身不区分信用卡、储蓄卡,Luhn 只是通用格式校验;如果需要区分卡类型,需要额外增加卡 BIN 号匹配逻辑。
问题 4:银行卡号中间带空格输入,这个 Java 工具类的 Luhn 校验会不会校验失败?
回答 4:不会,这个 Java 工具类里的 clearBlank 方法会先清除卡号空格,再交给 Luhn 校验方法处理,用户带空格输入的场景可以正常兼容。
【参考资料】
[2026-11-10](Java 银行卡 Luhn 校验工具类实现)掘金
[2026-10-27](Luhn 算法原理与 Java 代码实现)CSDN
[2026-09-15](银行卡号校验规范、Luhn 算法说明)支付宝开放平台文档
[2026-08-02](金融开发卡号校验安全规范)InfoQ
【免责声明】
本文介绍的 Java 工具类及 Luhn 校验仅用于卡号格式预校验,不能作为银行卡真实性、账户有效性的判定依据;生产环境使用前务必充分自测,做好卡号数据脱敏,该工具不承担金融业务核验责任,不构成金融对接方案。
