执行CREATE TABLE后出现列名错误，相关问题定位及解决方法咨询

排查步骤 #

• 校验SQL语句中的列名是否包含Access保留字（例如NAME、DATE、VALUE等），保留字作为列名未加特殊包裹时会被UCanAccess识别错误
• 核对列名长度，Access对列名的最大长度限制为64个字符，超出长度的部分会被自动截断，导致列名与预期不符
• 确认当前使用的UCanAccess版本，旧版本（低于5.0.1）存在列名编码解析bug，会对包含中文、特殊符号的列名出现识别偏差
• 检查依赖的Jackcess版本是否与UCanAccess版本匹配，两者版本不兼容时会出现元数据解析异常，导致列名读取错误
• 排查建表时是否配置了非默认的列名转换规则，UCanAccess连接参数中columnNamePattern如果配置了自定义规则，会强制修改列名格式

解决方案 #

• 涉及保留字的列名统一用方括号包裹，建表语句示例：

  CREATE TABLE test_table ([id] INT, [user_name] VARCHAR(32), [create_time] DATETIME)
  

• 列名长度控制在64字符以内，特殊符号建议替换为下划线，避免编码适配问题
• UCanAccess与Jackcess版本不兼容是触发该问题的最高频原因，优先升级UCanAccess到最新稳定版，同时同步升级配套的Jackcess、HSQLDB、commons-logging等依赖
• 若必须使用旧版本UCanAccess，可在连接URL中添加参数;columnCase=lower或;columnCase=upper强制统一列名大小写，避免大小写识别偏差
• 建表完成后主动调用DatabaseMetaData.getColumns()接口校验返回的列名是否与预期一致，若不一致可通过重命名列的语句修正：

  ALTER TABLE test_table RENAME COLUMN wrong_column_name TO correct_column_name
  

内容的提问来源于stack exchange，提问作者sproketboy