Go属性可见性与API设计：LineItem价格计算逻辑实现难题

针对你遇到的LineItem结构体既要让SQLx/JSON赋值Price字段，又要强制业务层通过方法获取计算后真实价格的问题，这里提供几个更合理的解决方案：

方案一：公有字段+废弃注释+团队约束（低成本） #

保留Price为公有字段，但通过注释明确标记废弃，同时配合团队lint规则禁止直接访问，只允许调用Price()方法获取真实值。

type LineItem struct {
    ID       int     `db:"id" json:"id"`
    OrderID  int     `db:"order_id" json:"order_id"`
    Refunded bool    `db:"refunded" json:"refunded"`
    Price    float64 `db:"price" json:"price"` // Deprecated: 请使用Price()方法获取真实价格
}

func (li *LineItem) Price() float64 {
    if li.Refunded {
        return 0.00
    }
    return li.Price
}

• 优势：无需额外结构体，SQLx和JSON直接兼容，实现成本极低；
• 劣势：依赖团队规范和lint工具，无法从语言层面强制阻止直接访问字段。

方案二：嵌入私有结构体（严格封装+无额外结构体） #

把需要ORM/JSON赋值的字段放到一个私有嵌入结构体中，对外结构体只暴露业务方法，既满足SQLx的字段解析需求，又保证封装性。

type LineItem struct {
    data     lineItemData // 嵌入私有结构体，SQLx可通过标签解析内部字段
    Refunded bool         `db:"refunded" json:"refunded"`
}

// 私有结构体，存放数据库交互字段
type lineItemData struct {
    ID      int     `db:"id" json:"id"`
    OrderID int     `db:"order_id" json:"order_id"`
    Price   float64 `db:"price" json:"price"`
}

// 获取真实价格的业务方法
func (li *LineItem) Price() float64 {
    if li.Refunded {
        return 0.00
    }
    return li.data.Price
}

// 按需暴露其他字段的访问方法
func (li *LineItem) ID() int {
    return li.data.ID
}

func (li *LineItem) OrderID() int {
    return li.data.OrderID
}

• 优势：从语言层面阻止外部直接修改Price，SQLx和JSON可正常解析嵌入结构体的字段；
• 劣势：需要为每个业务层需要访问的字段编写对应的getter方法，稍微繁琐。

方案三：双结构体+转换方法（完全分层） #

保留数据层的ExportedLineItem和业务层的LineItem，为ExportedLineItem实现转换方法，替代手动赋值的繁琐操作。

// 数据层结构体：用于SQLx查询和JSON序列化，所有字段公有
type ExportedLineItem struct {
    ID       int     `db:"id" json:"id"`
    OrderID  int     `db:"order_id" json:"order_id"`
    Refunded bool    `db:"refunded" json:"refunded"`
    Price    float64 `db:"price" json:"price"`
}

// 业务层结构体：所有字段私有，仅暴露业务方法
type LineItem struct {
    id       int
    orderID  int
    refunded bool
    price    float64
}

// 从数据层结构体转换为业务层结构体的方法
func (eli *ExportedLineItem) ToLineItem() LineItem {
    return LineItem{
        id:       eli.ID,
        orderID:  eli.OrderID,
        refunded: eli.Refunded,
        price:    eli.Price,
    }
}

// 获取真实价格的业务方法
func (li *LineItem) Price() float64 {
    if li.refunded {
        return 0.00
    }
    return li.price
}

// 按需暴露其他字段的访问方法
func (li *LineItem) ID() int { return li.id }
func (li *LineItem) OrderID() int { return li.orderID }
func (li *LineItem) Refunded() bool { return li.refunded }

使用方式示例：

var eli ExportedLineItem
// SQLx查询数据到eli
lineItem := eli.ToLineItem()
// 业务层调用lineItem.Price()获取真实价格

• 优势：完全隔离数据层和业务层，封装性最好，业务层字段可灵活扩展逻辑；
• 劣势：需要维护两个结构体，字段变更时需同步修改转换方法，可通过go generate工具自动生成转换代码减少重复工作。

方案选择建议 #

• 若团队规范执行力强，优先选方案一，实现成本最低；
• 若想要严格封装且不想维护双结构体，选方案二；
• 若追求数据层与业务层完全分离，或业务层需要复杂的字段逻辑，选方案三。

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