本文详解如何使用 Java 正则表达式精确匹配形如 [#d][#h][#m][#s] 的时间持续时间字符串，要求字段可选、顺序固定、单位合法，杜绝乱序（如 2m1h）或非法单位（如 2k30s）。
本文详解如何使用 java 正则表达式精确匹配形如 `[#d][#h][#m][#s]` 的时间持续时间字符串，要求字段可选、顺序固定、单位合法，杜绝乱序（如 `2m1h`）或非法单位（如 `2k30s`）。
要正确校验 [#d][#h][#m][#s] 格式的时间持续时间（例如 1h2s、2m15s、3d），关键在于：正则必须强制字段按 d→h→m→s 严格顺序出现，且仅允许这四个单位，不允许跳序、倒序或插入非法字符。
你原代码中：
duration.matches("(\d+d)?(\d+h)?(\d+m)?(\d+s)?")看似合理，但存在两个致命问题：
- 未锚定边界：matches() 默认要求整个字符串完全匹配，但该正则本身未显式禁止中间非法字符——不过真正的问题在第2点；
- 逻辑漏洞：允许“空匹配” —— 因为所有分组都是 ?（零次或一次），当输入为 "2k30s" 时，正则会尝试匹配：(d+d)? → 不匹配（跳过），(d+h)? → 不匹配（跳过），(d+m)? → 不匹配（跳过），(d+s)? → 匹配 "30s"，其余 "2k" 被忽略？❌ 实际上不会——matches() 要求整个字符串被正则覆盖。问题在于：该正则没有排除其他字符，但更核心的缺陷是——它无法阻止 2k30s 中的 k 被“跳过”，因为正则不强制消费全部输入？等等，这不对。
? 真相是："2k30s".matches("(\d+d)?(\d+h)?(\d+m)?(\d+s)?") 实际返回 false —— 因为你用的是 matches()，它等价于 ^...$。而 "2k30s" 无法被该正则任何组合覆盖（k 不属于 d/h/m/s，且无对应分组），所以应直接失败。但你观察到“始终 Valid”，极可能是因为测试时未正确检查返回值（你只调用了 matches() 却没用 if 判断结果，或误将异常捕获逻辑当作校验逻辑）。
立即学习“Java免费学习笔记（深入）”；
你接手一个需求时，是不是经常这样："改一个小字段 → 结果把不相关的代码也改了"、"需求说得很模糊 → 做着做着发现跑偏了"、"数据库加个字段 → 上线才发现漏了数据兼容"、"做了个新功能 → 一个月后自己都忘了当时怎么设计的"、"写到一半被中断 → 再回来不知道从哪继续"；这个 Skill 就是专门解决这些问题的。 它会自动探测你的项目环境（JDK、Spring Boot、ORM、数据库、前端框架），记在
✅ 正确解法如下：
✅ 推荐正则（精准、简洁、可靠）
String regex = "^((\d+d)?(\d+h)?(\d+m)?(\d+s)?)$"; // 或更优写法（避免嵌套捕获，提升可读性）： String regex = "^\d*d?\d*h?\d*m?\d*s?$";
但注意：\d*d?\d*h?\d*m?\d*s? 存在歧义（如 123 可能被解释为 123s，但 123x 仍会因 x 无法匹配而失败）。最稳妥的是显式分组 + 行首行尾锚定：
String regex = "^(\d+d)?(\d+h)?(\d+m)?(\d+s)?$";
✅ 必须加 ^ 和 $（虽然 String.matches() 内部自动添加，但显式写出更清晰、防误）；
✅ 每个 (\d+X)? 表示“该单位段可有可无”，且 \d+ 要求至少一位数字（避免 d、h 单独出现）；
✅ 顺序固化：d 只能在最前，h 次之，依此类推，彻底杜绝 2m1h 类乱序。
✅ 完整验证示例
public class DurationValidator {
private static final String DURATION_REGEX = "^(\d+d)?(\d+h)?(\d+m)?(\d+s)?$";
public static void main(String[] args) {
String[] testCases = {"1h2s", "1m", "2m15s", "2h10s", "2m1h", "2k30s", "3d5h", "d", "123", ""};
for (String input : testCases) {
boolean valid = input.matches(DURATION_REGEX);
System.out.printf("%-10s → %s%n",
""" + input + """,
valid ? "Valid" : "Not Valid");
}
}
}输出：
"1h2s" → Valid "1m" → Valid "2m15s" → Valid "2h10s" → Valid "2m1h" → Not Valid ← 顺序错误 "2k30s" → Not Valid ← k 非法单位 "3d5h" → Valid "d" → Not Valid ← 缺少数值（\d+ 要求至少一位数字） "123" → Not Valid ← 无单位，默认不匹配任何段 "" → Valid ← 所有段都可选，空字符串合法（若需禁止，改用 ^(?=.)...$）
⚠️ 注意事项
- 若业务要求至少一个时间字段（即不允许空字符串），请改用：
^(\d+[dhms])(\d+[hms])?(\d+[ms])?(\d+s)?$ —— 但更推荐语义化写法：
^(\d+d|\d+h|\d+m|\d+s)(\d+h|\d+m|\d+s)?(\d+m|\d+s)?(\d+s)?$（复杂，不推荐）
更佳实践：先用基础正则匹配，再额外判断 input.isEmpty() == false。 - \d+ 表示一个或多个数字；若需支持 007s 等带前导零的格式，\d+ 已兼容；若需禁止前导零（如 01s 应作 1s），则改用 (0|[1-9]\d*)。
- Java 中反斜杠需双写，确保字符串字面量正确转义。
掌握此正则模式，即可稳健解析配置文件、API 参数或用户输入中的标准时间持续时间格式。
