diff --git a/viewsh-module-video/viewsh-module-video-server/src/main/java/com/viewsh/module/video/gb28181/bean/PlatformChannel.java b/viewsh-module-video/viewsh-module-video-server/src/main/java/com/viewsh/module/video/gb28181/bean/PlatformChannel.java
index 33205103..85f893ec 100644
--- a/viewsh-module-video/viewsh-module-video-server/src/main/java/com/viewsh/module/video/gb28181/bean/PlatformChannel.java
+++ b/viewsh-module-video/viewsh-module-video-server/src/main/java/com/viewsh/module/video/gb28181/bean/PlatformChannel.java
@@ -1,5 +1,6 @@
 package com.viewsh.module.video.gb28181.bean;
 
+import com.baomidou.mybatisplus.annotation.TableField;
 import com.baomidou.mybatisplus.annotation.TableName;
 import io.swagger.v3.oas.annotations.media.Schema;
 import lombok.Data;
@@ -70,7 +71,8 @@ public class PlatformChannel extends CommonGBChannel {
     @Schema(description = "国标-证书终止有效期(有证书且证书无效的设备必选)")
     private Integer customEndTime;
 
-    // 2022
+    // 2022 扩展字段：SQL 尚未建列，@TableField(exist=false) 防止 BaseMapperX 反射写入
+    @TableField(exist = false)
     @Schema(description = "国标-摄像机安全能力等级代码")
     private String customSecurityLevelCode;
 
@@ -106,9 +108,13 @@ public class PlatformChannel extends CommonGBChannel {
             "8-校园周边、9-治安复杂区域、10-交通干线。当目录项为摄像机时可选。")
     private Integer customPositionType;
 
+    // 2022
+    @TableField(exist = false)
     @Schema(description = "国标-摄像机光电成像类型。1-可见光成像;2-热成像;3-雷达成像;4-X光成像;5-深度光场成像;9-其他。可多值,")
     private String customPhotoelectricImagingTyp;
 
+    // 2022
+    @TableField(exist = false)
     @Schema(description = "国标-摄像机采集部位类型")
     private String customCapturePositionType;
 
@@ -130,6 +136,7 @@ public class PlatformChannel extends CommonGBChannel {
     private String customResolution;
 
     // 2022
+    @TableField(exist = false)
     @Schema(description = "国标-摄像机支持的码流编号列表,用于实时点播时指定码流编号(可选)")
     private String customStreamNumberList;
 
@@ -143,68 +150,84 @@ public class PlatformChannel extends CommonGBChannel {
     private Integer customSvcTimeSupportMode;
 
     // 2022
+    @TableField(exist = false)
     @Schema(description = "国标- SSVC增强层与基本层比例能力 ")
     private String customSsvcRatioSupportList;
 
     // 2022
+    @TableField(exist = false)
     @Schema(description = "国标-移动采集设备类型(仅移动采集设备适用,必选);1-移动机器人载摄像机;2-执法记录仪;3-移动单兵设备;" +
             "4-车载视频记录设备;5-无人机载摄像机;9-其他")
     private Integer customMobileDeviceType;
 
     // 2022
+    @TableField(exist = false)
     @Schema(description = "国标-摄像机水平视场角(可选),取值范围大于0度小于等于360度")
     private Double customHorizontalFieldAngle;
 
     // 2022
+    @TableField(exist = false)
     @Schema(description = "国标-摄像机竖直视场角(可选),取值范围大于0度小于等于360度 ")
     private Double customVerticalFieldAngle;
 
     // 2022
+    @TableField(exist = false)
     @Schema(description = "国标-摄像机可视距离(可选),单位:米")
     private Double customMaxViewDistance;
 
     // 2022
+    @TableField(exist = false)
     @Schema(description = "国标-基层组织编码(必选,非基层建设时为“000000”)")
     private String customGrassrootsCode;
 
     // 2022
+    @TableField(exist = false)
     @Schema(description = "国标-监控点位类型(当为摄像机时必选),1-一类视频监控点;2-二类视频监控点;3-三类视频监控点;9-其他点位。")
     private Integer customPoType;
 
     // 2022
+    @TableField(exist = false)
     @Schema(description = "国标-点位俗称")
     private String customPoCommonName;
 
     // 2022
+    @TableField(exist = false)
     @Schema(description = "国标-设备MAC地址(可选),用“XX-XX-XX-XX-XX-XX”格式表达")
     private String customMac;
 
     // 2022
+    @TableField(exist = false)
     @Schema(description = "国标-摄像机卡口功能类型,01-人脸卡口;02-人员卡口;03-机动车卡口;04-非机动车卡口;05-物品卡口;99-其他")
     private String customFunctionType;
 
     // 2022
+    @TableField(exist = false)
     @Schema(description = "国标-摄像机视频编码格式")
     private String customEncodeType;
 
     // 2022
+    @TableField(exist = false)
     @Schema(description = "国标-摄像机安装使用时间")
     private String customInstallTime;
 
     // 2022
+    @TableField(exist = false)
     @Schema(description = "国标-摄像机所属管理单位名称")
     private String customManagementUnit;
 
     // 2022
+    @TableField(exist = false)
     @Schema(description = "国标-摄像机所属管理单位联系人的联系方式(电话号码,可多值,用英文半角“/”分割)")
     private String customContactInfo;
 
     // 2022
+    @TableField(exist = false)
     @Schema(description = "国标-录像保存天数(可选)")
     private Integer customRecordSaveDays;
 
     // 2022
+    @TableField(exist = false)
     @Schema(description = "国标-国民经济行业分类代码(可选)")
     private String customIndustrialClassification;
-    
+
 }
diff --git a/viewsh-module-video/viewsh-module-video-server/src/main/java/com/viewsh/module/video/streamProxy/dao/StreamProxyMapper.java b/viewsh-module-video/viewsh-module-video-server/src/main/java/com/viewsh/module/video/streamProxy/dao/StreamProxyMapper.java
index 665d3a4b..b0870515 100644
--- a/viewsh-module-video/viewsh-module-video-server/src/main/java/com/viewsh/module/video/streamProxy/dao/StreamProxyMapper.java
+++ b/viewsh-module-video/viewsh-module-video-server/src/main/java/com/viewsh/module/video/streamProxy/dao/StreamProxyMapper.java
@@ -10,6 +10,18 @@ import org.springframework.stereotype.Repository;
 
 import java.util.List;
 
+/**
+ * 拉流代理 Mapper。
+ *
+ * <p><b>注意</b>：StreamProxy 继承自 {@link com.viewsh.module.video.gb28181.bean.CommonGBChannel}，
+ * 带入 40+ 个 {@code gb_*} 字段，但 {@code video_stream_proxy} 表<b>不含这些列</b>
+ * （国标通道信息统一落在 {@code video_common_gb_channel} 表，由 GbChannelService 另写入）。
+ * 因此<b>严禁使用</b> {@link BaseMapperX} 的 {@code insert(entity)} / {@code updateById(entity)} /
+ * {@code selectByMap(Map)} 等自动映射方法，否则会因反射包含 {@code gb_*} 字段导致
+ * {@code Unknown column 'gb_device_id'} 运行时错误。写入必须走下方显式 SQL 方法
+ * （{@link #add}、{@link #update}）；读取可用 BaseMapperX 的 {@code selectById} / {@code selectList}
+ * （只涉及 SELECT，gb_* 字段对应 null 而非报错）。
+ */
 @Mapper
 @Repository
 public interface StreamProxyMapper extends BaseMapperX<StreamProxy> {
diff --git a/viewsh-module-video/viewsh-module-video-server/src/main/java/com/viewsh/module/video/streamPush/dao/StreamPushMapper.java b/viewsh-module-video/viewsh-module-video-server/src/main/java/com/viewsh/module/video/streamPush/dao/StreamPushMapper.java
index 23dea8a0..ac384a82 100644
--- a/viewsh-module-video/viewsh-module-video-server/src/main/java/com/viewsh/module/video/streamPush/dao/StreamPushMapper.java
+++ b/viewsh-module-video/viewsh-module-video-server/src/main/java/com/viewsh/module/video/streamPush/dao/StreamPushMapper.java
@@ -13,6 +13,18 @@ import java.util.List;
 import java.util.Map;
 import java.util.Set;
 
+/**
+ * 推流 Mapper。
+ *
+ * <p><b>注意</b>：StreamPush 继承自 {@link com.viewsh.module.video.gb28181.bean.CommonGBChannel}，
+ * 带入 40+ 个 {@code gb_*} 字段，但 {@code video_stream_push} 表<b>不含这些列</b>
+ * （国标通道信息统一落在 {@code video_common_gb_channel} 表，由 GbChannelService 另写入）。
+ * 因此<b>严禁使用</b> {@link BaseMapperX} 的 {@code insert(entity)} / {@code updateById(entity)} /
+ * {@code selectByMap(Map)} 等自动映射方法，否则会因反射包含 {@code gb_*} 字段导致
+ * {@code Unknown column 'gb_device_id'} 运行时错误。写入必须走下方显式 SQL 方法
+ * （{@link #add}、{@link #update}、{@link #addAll}）；读取可用 BaseMapperX 的
+ * {@code selectById} / {@code selectList}（只涉及 SELECT，gb_* 字段对应 null 而非报错）。
+ */
 @Mapper
 @Repository
 public interface StreamPushMapper extends BaseMapperX<StreamPush> {