0

0

如何在 GORM 中将 Go 结构体字段映射到含下划线的 MySQL 列名

聖光之護

聖光之護

发布时间:2026-01-21 14:03:45

|

792人浏览过

|

来源于php中文网

原创

如何在 GORM 中将 Go 结构体字段映射到含下划线的 MySQL 列名

gorm 默认使用蛇形命名(snake_case)自动映射结构体字段到数据库列,但当结构体字段名与实际数据库列名不一致(如数据库列为 spe_name,而字段为 spename)时,需通过 `gorm:"column:xxx"` 标签显式指定列名映射。

在使用 GORM(尤其是 v1.x 版本)开发时,若数据库表中存在带下划线的字段名(例如 spe_Name、parent_id),而 Go 结构体采用驼峰命名(如 SpeName、ParentId),GORM 不会自动将 SpeName 映射到 spe_Name —— 它默认尝试映射到 spe_name(全小写+下划线),而非保留大小写的 spe_Name。这正是你遇到 specialty.SpeName 打印为空的原因:字段未正确从数据库读取,GORM 因列名不匹配而跳过赋值。

✅ 正确做法是使用 GORM 的结构体标签 gorm:"column:实际列名" 显式声明映射关系:

type Specialties struct {
    SpeId      int64          `gorm:"column:spe_Id"`      // 映射到数据库列 spe_Id
    SpeName    string         `gorm:"column:spe_Name"`    // 关键:明确指向 spe_Name
    Conditions sql.NullString `gorm:"column:conditions"`
    ParentId   sql.NullInt64  `gorm:"column:parent_id"`   // 若数据库实际为 parent_id,此处也需对应
    Hidden     sql.NullInt64  `gorm:"column:hidden"`
    // 注意:GORM 要求主键字段需显式标记或符合约定(如 ID 或 XxxId)
    // 若 spe_Id 是主键,建议补充 `gorm:"primaryKey"`
}

? 补充说明与最佳实践:

  • 主键识别:若 spe_Id 是主键,强烈建议添加 gorm:"primaryKey" 标签,避免 GORM 推断失败:

    SpeId int64 `gorm:"column:spe_Id;primaryKey"`
  • 零值安全:sql.NullString 和 sql.NullInt64 已正确处理 NULL,但确保数据库该列允许 NULL;否则应改用非空类型(如 string, int64)并配合 gorm:"default:0" 等约束。

    VWO
    VWO

    一个A/B测试工具

    下载
  • 调试技巧:启用 GORM 日志快速验证 SQL 是否按预期执行:

    db.LogMode(true) // v1.x;v2 使用 db.Debug()
  • 全局命名策略(可选):若整个项目均使用大小写敏感的蛇形列名(如 spe_Name),可通过自定义 naming_strategy 配置统一处理(GORM v2 支持更强),但显式 column: 标签仍是最清晰、最可控的方式。

最后,请确认你的 Specialties 变量(在 IsFolderNameASpecialty 函数中遍历的)确实已通过 GORM 查询(如 db.Find(&Specialties))从数据库加载了真实数据——结构体标签仅解决映射问题,不解决数据未加载的问题。

相关专题

更多
数据分析工具有哪些
数据分析工具有哪些

数据分析工具有Excel、SQL、Python、R、Tableau、Power BI、SAS、SPSS和MATLAB等。详细介绍:1、Excel,具有强大的计算和数据处理功能;2、SQL,可以进行数据查询、过滤、排序、聚合等操作;3、Python,拥有丰富的数据分析库;4、R,拥有丰富的统计分析库和图形库;5、Tableau,提供了直观易用的用户界面等等。

683

2023.10.12

SQL中distinct的用法
SQL中distinct的用法

SQL中distinct的语法是“SELECT DISTINCT column1, column2,...,FROM table_name;”。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

323

2023.10.27

SQL中months_between使用方法
SQL中months_between使用方法

在SQL中,MONTHS_BETWEEN 是一个常见的函数,用于计算两个日期之间的月份差。想了解更多SQL的相关内容,可以阅读本专题下面的文章。

348

2024.02.23

SQL出现5120错误解决方法
SQL出现5120错误解决方法

SQL Server错误5120是由于没有足够的权限来访问或操作指定的数据库或文件引起的。想了解更多sql错误的相关内容,可以阅读本专题下面的文章。

1096

2024.03.06

sql procedure语法错误解决方法
sql procedure语法错误解决方法

sql procedure语法错误解决办法:1、仔细检查错误消息;2、检查语法规则;3、检查括号和引号;4、检查变量和参数;5、检查关键字和函数;6、逐步调试;7、参考文档和示例。想了解更多语法错误的相关内容,可以阅读本专题下面的文章。

358

2024.03.06

oracle数据库运行sql方法
oracle数据库运行sql方法

运行sql步骤包括:打开sql plus工具并连接到数据库。在提示符下输入sql语句。按enter键运行该语句。查看结果,错误消息或退出sql plus。想了解更多oracle数据库的相关内容,可以阅读本专题下面的文章。

697

2024.04.07

sql中where的含义
sql中where的含义

sql中where子句用于从表中过滤数据,它基于指定条件选择特定的行。想了解更多where的相关内容,可以阅读本专题下面的文章。

577

2024.04.29

sql中删除表的语句是什么
sql中删除表的语句是什么

sql中用于删除表的语句是drop table。语法为drop table table_name;该语句将永久删除指定表的表和数据。想了解更多sql的相关内容,可以阅读本专题下面的文章。

418

2024.04.29

AO3中文版入口地址大全
AO3中文版入口地址大全

本专题整合了AO3中文版入口地址大全,阅读专题下面的的文章了解更多详细内容。

1

2026.01.21

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
MySQL 教程
MySQL 教程

共48课时 | 1.8万人学习

MySQL 初学入门(mosh老师)
MySQL 初学入门(mosh老师)

共3课时 | 0.3万人学习

简单聊聊mysql8与网络通信
简单聊聊mysql8与网络通信

共1课时 | 804人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号