refactor: ID confusion with CRC8 check sum

HackyleShawe · HackyleShawe · commit 4ebeb2d10b1f · 2026-01-08T10:32:52.000+08:00
diff --git a/blog-admin/src/main/java/com/hackyle/blog/admin/module/article/service/impl/IdConfusionServiceImpl.java b/blog-admin/src/main/java/com/hackyle/blog/admin/module/article/service/impl/IdConfusionServiceImpl.java
@@ -1,9 +1,13 @@
 package com.hackyle.blog.admin.module.article.service.impl;
 
 import com.hackyle.blog.admin.module.article.service.IdConfusionService;
+import com.hackyle.blog.common.exception.BizException;
+import com.hackyle.blog.common.util.CrcUtils;
 import org.springframework.beans.factory.annotation.Value;
 import org.springframework.stereotype.Service;
 
+import java.util.Objects;
+
 /**
  * ID混淆
  */
@@ -19,6 +23,7 @@ public class IdConfusionServiceImpl implements IdConfusionService {
      * 先模62，从Base62字符数组中取得一个字符
      * 再除62，直到num小于0时停止
      * 得到一个唯一串
+     * 计算CRC8校验码
      */
     public String encode(long id) {
         if(id < 0) {
@@ -35,20 +40,35 @@ public String encode(long id) {
         //while (sb.length() < CODE_LENGTH) {
         //    sb.append('0'); // 也可填充随机字符
         //}
-        return sb.reverse().toString(); // 高位在前
+
+        //计算CRC8校验码
+        String code = sb.reverse().toString();
+        char crc8CheckSum = CrcUtils.crc8CheckSum(code);
+        if(Character.isWhitespace(crc8CheckSum)) {
+            throw new BizException("CRC8 Check Sum 计算失败");
+        }
+
+        return code + crc8CheckSum; // 高位在前
     }
 
     /**
+     * 检查校验码
      * 依次遍历唯一串的每个字符c
      * 从字符数组中找到该个字符c所在的下标i
      * id = id*62+i
      * 最终解析出的值即为原始id
      */
     public long decode(String code) {
+        String body = code.substring(0, code.length() - 1);
+        char crc8CheckSum = code.charAt(code.length() - 1);
+        if(!Objects.equals(crc8CheckSum, CrcUtils.crc8CheckSum(body))) {
+            throw new BizException("CRC8 Check Sum 校验失败");
+        }
+
         long id = 0;
         int baseSize = idConfusionBaseChar.length();
 
-        for (char cc : code.toCharArray()) {
+        for (char cc : body.toCharArray()) {
             Integer mod = null;
             for (int j = 0; j < baseSize; j++) {
                 if(cc == idConfusionBaseChar.charAt(j)) {
diff --git a/blog-common/src/main/java/com/hackyle/blog/common/util/CrcUtils.java b/blog-common/src/main/java/com/hackyle/blog/common/util/CrcUtils.java
@@ -0,0 +1,72 @@
+package com.hackyle.blog.common.util;
+
+import java.nio.charset.StandardCharsets;
+import java.util.Random;
+
+/**
+ * CRC（Cyclic Redundancy Check，循环冗余校验）算法工具类
+ */
+public class CrcUtils {
+
+    private static final int POLY = 0x07; // CRC-8 标准多项式
+
+    //用于生成校验位的字符集
+    //private static final char[] BASE32 = "ABCDEFGHIJKLMNOPQRSTUVWXYZ234567".toCharArray();
+    private static final char[] BASE62 = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789".toCharArray();
+
+    /**
+     * 标准CRC8
+     * 多项式	0x07
+     * 初始值	0x00
+     */
+    private static byte crc8(byte[] data) {
+        int crc = 0x00;
+
+        for (byte b : data) {
+            crc ^= (b & 0xFF);
+            for (int i = 0; i < 8; i++) {
+                if ((crc & 0x80) != 0) {
+                    crc = ((crc << 1) ^ POLY) & 0xFF;
+                } else {
+                    crc = (crc << 1) & 0xFF;
+                }
+            }
+        }
+        return (byte) crc;
+    }
+
+    /**
+     * CRC8校验码编码
+     * @param data 原始数据
+     * @return 校验
+     */
+    public static char crc8CheckSum(String data) {
+        //**isEmpty()**：判断是不是“空字符串”
+        //**isBlank()**：判断是不是“空白字符串”（包含空格、制表符、换行符这些）
+        if(data == null || data.trim().isBlank()) {
+            throw new IllegalArgumentException("CRC8 Encoded String is null or empty");
+        }
+        byte crc8 = crc8(data.getBytes(StandardCharsets.UTF_8));
+        return BASE62[(crc8 & 0xFF) % BASE62.length];
+    }
+
+    public static void main(String[] args) {
+        Random random = new Random();
+        for (int i = 0; i < 10; i++) {
+            String str = "Asdfaddu1234" + random.nextLong();
+            char crc8CheckSum = CrcUtils.crc8CheckSum(str);
+            System.out.println(crc8CheckSum);
+
+            String code = str + crc8CheckSum;
+
+            int randIndex = random.nextInt(3);
+            String body = code.substring(0, code.length() - randIndex);
+            char check = code.charAt(code.length() - 1);
+            boolean result = CrcUtils.crc8CheckSum(body) == check;
+            //如果randIndex=1，则校验结果应该为true
+            System.out.println("====== randIndex=" + randIndex + " result=" +result);
+
+        }
+    }
+
+}
diff --git a/blog-customer/src/main/java/com/hackyle/blog/customer/handler/GlobalExceptionHandler.java b/blog-customer/src/main/java/com/hackyle/blog/customer/handler/GlobalExceptionHandler.java
@@ -41,11 +41,16 @@
 public class GlobalExceptionHandler {
 
     //@ResponseStatus(HttpStatus.UNPROCESSABLE_ENTITY)
-    @ResponseBody
     @ExceptionHandler(BizException.class)
-    public ApiResponse<Exception> bizExceptionHandler(HttpServletRequest request, BizException exception) {
+    public ModelAndView bizExceptionHandler(HttpServletRequest request, BizException exception) {
         log.error("出现BizException异常：", exception);
-        return ApiResponse.fail(HttpStatus.UNPROCESSABLE_ENTITY.value(), exception.getMessage());
+
+        ModelAndView modelAndView = new ModelAndView();
+        modelAndView.addObject("code", HttpStatus.NOT_FOUND);
+        modelAndView.addObject("message", exception.getMessage());
+        modelAndView.addObject("url", request.getRequestURL());
+        modelAndView.setViewName("common/404");
+        return modelAndView;
     }
 
     //@ResponseStatus(HttpStatus.NOT_FOUND)
diff --git a/blog-customer/src/main/java/com/hackyle/blog/customer/module/article/service/impl/IdConfusionServiceImpl.java b/blog-customer/src/main/java/com/hackyle/blog/customer/module/article/service/impl/IdConfusionServiceImpl.java
@@ -1,12 +1,15 @@
 package com.hackyle.blog.customer.module.article.service.impl;
 
 import cn.hutool.core.collection.CollectionUtil;
+import com.hackyle.blog.common.exception.BizException;
+import com.hackyle.blog.common.util.CrcUtils;
 import com.hackyle.blog.customer.module.article.service.IdConfusionService;
 import org.springframework.beans.factory.annotation.Value;
 import org.springframework.stereotype.Service;
 
 import java.util.ArrayList;
 import java.util.List;
+import java.util.Objects;
 
 /**
  * ID混淆
@@ -27,6 +30,7 @@ public class IdConfusionServiceImpl implements IdConfusionService {
      * 先模62，从Base62字符数组中取得一个字符
      * 再除62，直到num小于0时停止
      * 得到一个唯一串
+     * 计算CRC8校验码
      */
     public String encode(long id) {
         if(id < 0) {
@@ -43,20 +47,35 @@ public String encode(long id) {
         //while (sb.length() < CODE_LENGTH) {
         //    sb.append('0'); // 也可填充随机字符
         //}
-        return sb.reverse().toString(); // 高位在前
+
+        //计算CRC8校验码
+        String code = sb.reverse().toString();
+        char crc8CheckSum = CrcUtils.crc8CheckSum(code);
+        if(Character.isWhitespace(crc8CheckSum)) {
+            throw new BizException("CRC8 Check Sum 计算失败");
+        }
+
+        return code + crc8CheckSum; // 高位在前
     }
 
     /**
+     * 检查校验码
      * 依次遍历唯一串的每个字符c
      * 从字符数组中找到该个字符c所在的下标i
      * id = id*62+i
      * 最终解析出的值即为原始id
      */
     public long decode(String code) {
+        String body = code.substring(0, code.length() - 1);
+        char crc8CheckSum = code.charAt(code.length() - 1);
+        if(!Objects.equals(crc8CheckSum, CrcUtils.crc8CheckSum(body))) {
+            throw new BizException("CRC8 Check Sum 校验失败");
+        }
+
         long id = 0;
         int baseSize = baseChar.length();
 
-        for (char cc : code.toCharArray()) {
+        for (char cc : body.toCharArray()) {
             Integer mod = null;
             for (int j = 0; j < baseSize; j++) {
                 if(cc == baseChar.charAt(j)) {
