Gorm默认按ID查询而非merchant_id问题求助

问题场景 #

定义了如下MerchantCsvMapping结构体及对应数据库表结构：

结构体代码 #

type MerchantCsvMapping struct {
    gorm.Model
    MerchantID       int 
    Name             string
    NameDe           string
    ProductNo        string
    PriceOld         string
    Ean              string
    Price            string
    Category         int
    DeepLink         string
    ShortDescription string
    LongDescription  string
    BrandMerchant    int
    MerchantImageURL string
    AlternateImage   string
    GalleryImage     int
    GalleryImage2    int
    GalleryImage3    int
    GalleryImage4    int
    DeliveryTime     string
    DeliveryCost     string
}

数据库表结构 #

1   id  bigint unsigned NULL    NULL    NO  NULL    auto_increment      
2   merchant_id bigint unsigned NULL    NULL    NO  NULL        merchants(id)   
3   name    int unsigned    NULL    NULL    YES NULL            
4   product_no  int unsigned    NULL    NULL    YES NULL            
5   price_old   bigint unsigned NULL    NULL    YES NULL            
6   ean int unsigned    NULL    NULL    YES NULL            
7   price   bigint unsigned NULL    NULL    YES NULL            
8   category    int unsigned    NULL    NULL    YES NULL            
9   deep_link   int unsigned    NULL    NULL    YES NULL            
10  short_description   int unsigned    NULL    NULL    YES NULL            
11  long_description    int unsigned    NULL    NULL    YES NULL            
12  brand_merchant  int unsigned    NULL    NULL    YES NULL            
13  merchant_image_url  int unsigned    NULL    NULL    YES NULL            
14  alternate_image int unsigned    NULL    NULL    YES NULL            
15  gallery_image   bigint unsigned NULL    NULL    YES NULL            
16  gallery_image2  bigint unsigned NULL    NULL    YES NULL            
17  gallery_image3  bigint unsigned NULL    NULL    YES NULL            
18  gallery_image4  bigint unsigned NULL    NULL    YES NULL            
19  delivery_time   int unsigned    NULL    NULL    YES NULL            
20  delivery_cost   int unsigned    NULL    NULL    YES NULL            
21  created_at  timestamp   NULL    NULL    YES NULL            
22  updated_at  timestamp   NULL    NULL    YES NULL            
23  deleted_at  timestamp   NULL    NULL    YES NULL            

执行以下代码时：

db.First(&merchant_csv_mapping, Feed.MerchantID) // Feed.MerchantID=1

返回的是id=1、merchant_id=29的条目，但实际需要查询merchant_id=1的条目，Gorm总是优先按ID字段匹配而非merchant_id。

原因分析 #

Gorm的First方法在仅传入单个值参数时，默认会将该值匹配到模型的主键字段（由于结构体继承了gorm.Model，其中包含ID主键），因此传入的1会被当作id字段的值进行查询，而非merchant_id。

解决方案 #

方法1：明确指定查询字段（结构体/Map方式） #

通过结构体或Map明确指定查询条件，告诉Gorm要匹配merchant_id字段：

• 结构体方式：

db.First(&merchant_csv_mapping, MerchantCsvMapping{MerchantID: Feed.MerchantID})

• Map方式：

db.First(&merchant_csv_mapping, map[string]interface{}{"merchant_id": Feed.MerchantID})

方法2：使用Where条件语句 #

直接通过Where子句指定查询条件，逻辑更清晰：

db.Where("merchant_id = ?", Feed.MerchantID).First(&merchant_csv_mapping)

可选优化：给merchant_id添加索引 #

如果业务中频繁按merchant_id查询，建议给数据库表的merchant_id字段添加索引，提升查询效率：

CREATE INDEX idx_merchant_csv_mapping_merchant_id ON merchant_csv_mappings(merchant_id);

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