diff --git a/ruoyi-modules/hw-portal/src/main/java/com/ruoyi/portal/service/impl/HwWebDocumentServiceImpl.java b/ruoyi-modules/hw-portal/src/main/java/com/ruoyi/portal/service/impl/HwWebDocumentServiceImpl.java
index 3c004e3..0ca351f 100644
--- a/ruoyi-modules/hw-portal/src/main/java/com/ruoyi/portal/service/impl/HwWebDocumentServiceImpl.java
+++ b/ruoyi-modules/hw-portal/src/main/java/com/ruoyi/portal/service/impl/HwWebDocumentServiceImpl.java
@@ -68,6 +68,12 @@ public class HwWebDocumentServiceImpl implements IHwWebDocumentService
     @Override
     public int updateHwWebDocument(HwWebDocument hwWebDocument)
     {
+        // 特殊处理 secretKey：前端不传或传 null 时清空数据库密钥
+        // 将 null 转换为空字符串，触发 Mapper 更新条件
+        if (hwWebDocument.getSecretKey() == null) {
+            hwWebDocument.setSecretKey("");
+        }
+        
         return hwWebDocumentMapper.updateHwWebDocument(hwWebDocument);
     }
 
@@ -103,13 +109,18 @@ public class HwWebDocumentServiceImpl implements IHwWebDocumentService
         }
         String secretKey = document.getSecretKey();
         String address = document.getDocumentAddress();
+        
+        // 若数据库密钥为空，则直接返回文件地址
         if (secretKey == null || secretKey.trim().isEmpty()) {
             return address;
         }
+        
+        // 若密钥不为空，则需要验证提供的密钥是否相等
         String trimmedProvided = providedKey == null ? null : providedKey.trim();
         if (trimmedProvided == null || trimmedProvided.isEmpty()) {
-            throw new ServiceException("密钥错误");
+            throw new ServiceException("密钥不能为空");
         }
+        
         if (secretKey.trim().equals(trimmedProvided)) {
             return address;
         } else {
diff --git a/ruoyi-modules/hw-portal/src/main/resources/mapper/portal/HwWebDocumentMapper.xml b/ruoyi-modules/hw-portal/src/main/resources/mapper/portal/HwWebDocumentMapper.xml
index d51d660..1e4e922 100644
--- a/ruoyi-modules/hw-portal/src/main/resources/mapper/portal/HwWebDocumentMapper.xml
+++ b/ruoyi-modules/hw-portal/src/main/resources/mapper/portal/HwWebDocumentMapper.xml
@@ -79,7 +79,12 @@ PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
             <if test="documentAddress != null">document_address = #{documentAddress},</if>
             <if test="createTime != null">create_time = #{createTime},</if>
             <if test="webCode != null">web_code = #{webCode},</if>
-            <if test="secretKey != null">secretKey = #{secretKey},</if>
+            <if test="secretKey != null">
+                secretKey = <choose>
+                    <when test="secretKey == ''">NULL</when>
+                    <otherwise>#{secretKey}</otherwise>
+                </choose>,
+            </if>
             <if test="json != null">json = #{json},</if>
             <if test="type != null">type = #{type},</if>
         </trim>