写在前面：为什么账户系统让我掉了不少头发

作为一个在支付行业摸爬滚打多年的架构师，我可以负责任地说：账户系统是整个支付体系里最容易让人秃头的模块。没有之一。

为什么？因为它涉及到钱。而钱这个东西，多一分少一分都是事故。记得我刚入行的时候，前辈语重心长地跟我说：

小伙子，做支付系统，差一分钱找三天是常态，差一块钱能让你过不好整个春节。

所以今天，我想用最通俗的方式，把账户系统的设计思路分享给大家。争取让各位少踩坑，多长发。

一、先搞清楚：你的系统里到底有哪些账户？

在开始写代码之前，我们得先理清一个问题：支付系统里到底有多少种账户？说实话，刚开始做的时候我也是一脸懵——不就是用户账户和商户账户吗？

图样图森破。让我给你画张图：

1.1 内部账户：公司的钱袋子们

内部账户是我们支付公司自己管理的账户，主要用来记录公司的资产、负债和收入。你可以把它想象成公司财务部的账本。

1.2 外部账户：别人的钱袋子

外部账户代表的是外部用户在我们系统里的资金。虽然钱在我们系统里记着，但本质上是人家的钱，我们只是帮忙管着。

这里有个很重要的概念：外部账户本质上是我们对外部用户的「负债」。用户存了100块，我们就欠他100块，这个要记清楚。

二、账户层级：像俄罗斯套娃一样设计

账户不能一锅粥，得分层管理。我喜欢把它比作公司组织架构——有集团、有部门、有小组、有个人。

2.1 每一级账户都有自己的使命

为什么要分这么多级？一句话：方便汇总和下钻。

三、领域模型设计

下面是账户系统的核心领域模型：

3.1 模型说明

3.2 上代码：账户数据模型（Go版）

// account.go - 账户核心模型

package account

import (
    "time"
    "github.com/shopspring/decimal"
)

// AccountTitle 会计科目
type AccountTitle struct {
    TitleCode        string `gorm:"primaryKey;size:32"`
    ParentTitleCode  string `gorm:"size:32;index"`
    TitleName        string `gorm:"size:128"`
    TitleType        string `gorm:"size:16"`          // ASSET/LIABILITY/INCOME/EXPENSE
    Currency         string `gorm:"size:3;default:CNY"`
    BalanceDirection int    `gorm:"default:1"`        // 1:借方 2:贷方
}

// Account 账户基类
type Account struct {
    AccountNo        string          `gorm:"primaryKey;size:32"`
    AccountName      string          `gorm:"size:128"`
    TitleCode        string          `gorm:"size:32;index"`
    BalanceDirection int             `gorm:"default:1"`
    Balance          decimal.Decimal `gorm:"type:decimal(20,2)"`
    FrozenAmount     decimal.Decimal `gorm:"type:decimal(20,2)"`
    Status           int             `gorm:"default:1"`
    CreatedAt        time.Time
    UpdatedAt        time.Time
}

// InnerAccount 内部账户
type InnerAccount struct {
    Account
    AccountCategory string `gorm:"size:32"` // RESERVE/FEE_INCOME/PENDING...
}

// OuterAccount 外部账户
type OuterAccount struct {
    Account
    MemberID    string `gorm:"size:32;index"`
    AccountType string `gorm:"size:16"` // SETTLEMENT/DEPOSIT/WALLET
}

// FundsChannel 资金渠道
type FundsChannel struct {
    ChannelCode      string `gorm:"primaryKey;size:32"`
    ChannelName      string `gorm:"size:64"`
    ChannelType      string `gorm:"size:16"`          // BANK/NUCC/CUPS
    PendingAccountNo string `gorm:"size:32"`          // 待清算账户
    CashAccountNo    string `gorm:"size:32"`          // 现金账户
    FeeAccountNo     string `gorm:"size:32"`          // 手续费账户
    VatAccountNo     string `gorm:"size:32"`          // 增值税账户
    Status           int    `gorm:"default:1"`
}

// Product 产品
type Product struct {
    ProductCode      string `gorm:"primaryKey;size:32"`
    ProductName      string `gorm:"size:64"`
    RevenueAccountNo string `gorm:"size:32"`          // 收入账户
}

四、记账：复式记账法其实没那么玄乎

说到记账，很多程序员就头大。别怕，核心就一句话：

有借必有贷，借贷必相等

翻译成人话：钱不会凭空出现也不会凭空消失，从一个口袋拿出来，必然要装进另一个口袋。

4.1 借贷方向速记表

记住一个口诀：资产借增贷减，负债贷增借减。

4.2 记账核心代码（Go版）

// ledger.go - 记账引擎核心

package ledger

import (
    "context"
    "fmt"
    "time"
    
    "github.com/shopspring/decimal"
    "gorm.io/gorm"
)

const (
    Debit  = 1 // 借
    Credit = 2 // 贷
)

// AccountingEntry 会计分录
type AccountingEntry struct {
    EntryID        string          `gorm:"primaryKey;size:64"`
    TxnID          string          `gorm:"size:64;index"`
    AccountNo      string          `gorm:"size:32;index"`
    Direction      int             `gorm:"index"`
    Amount         decimal.Decimal `gorm:"type:decimal(20,2)"`
    BalanceBefore  decimal.Decimal `gorm:"type:decimal(20,2)"`
    BalanceAfter   decimal.Decimal `gorm:"type:decimal(20,2)"`
    Summary        string          `gorm:"size:128"`
    AccountingDate string          `gorm:"size:10;index"`
    CreatedAt      time.Time
}

// LedgerService 记账服务
type LedgerService struct {
    db *gorm.DB
}

// Post 核心记账方法
func (s *LedgerService) Post(ctx context.Context, req *PostingRequest) error {
    // 1. 检查借贷是否平衡
    if err := s.checkBalance(req.Entries); err != nil {
        return fmt.Errorf("借贷不平衡: %w", err)
    }
    
    // 2. 幂等检查
    if exists := s.checkExists(ctx, req.BizOrderNo); exists {
        return nil
    }
    
    // 3. 开事务执行
    return s.db.Transaction(func(tx *gorm.DB) error {
        for _, entry := range req.Entries {
            if err := s.processEntry(tx, entry); err != nil {
                return err
            }
        }
        return nil
    })
}

// checkBalance 校验借贷平衡
func (s *LedgerService) checkBalance(entries []EntryRequest) error {
    var debit, credit decimal.Decimal
    for _, e := range entries {
        if e.Direction == Debit {
            debit = debit.Add(e.Amount)
        } else {
            credit = credit.Add(e.Amount)
        }
    }
    if !debit.Equal(credit) {
        return fmt.Errorf("借方%s != 贷方%s", debit, credit)
    }
    return nil
}

五、常见支付场景怎么记账？

5.1 场景一：用户充值100块

会计分录：

5.2 场景二：用户消费100块

5.3 场景三：商户提现1000块

六、日终对账：每天都要做的体检

6.1 差错类型

七、系统架构总览

八、血泪教训

1. 金额一定用Decimal。0.1 + 0.2 != 0.3 这个坑你不会想踩。
2. 记账必须在事务里。要么全成功，要么全失败。
3. 幂等性是刚需。同一笔单重复请求不能重复入账。
4. 每笔账都要可追溯。记账前余额、记账后余额全都要记。
5. 日终对账是救命的。再好的系统也会出bug。

问题

如何支持多币种?
如何支持非金额记账?
如何解决记账性能问题？

参考资料

Accounting for Developers
会计学原理
记账系统的go语言实现