1
# 自增 ID
2
1, 2, 3, 4, ...
3

4
# UUID
5
550e8400-e29b-41d4-a716-446655440000
6

7
# 雪花算法 ID
8
69329847238479872
9

10
# ULID
11
01ARZ3NDEKTSV4RRFFQ69G5FAV

1
-- 自增主键：B+ 树插入在末尾，效率高
2
INSERT INTO users VALUES (1000000, 'name');  -- 插入末尾
3

4
-- 随机 UUID：B+ 树随机插入，页分裂
5
INSERT INTO users VALUES ('550e8400-...', 'name');  -- 随机位置

1
# 有意义 ID 泄露业务信息
2
https://api.example.com/users/13824678
3
# 攻击者知道用户数量 ≈ 1382 万
4

5
# 无意义 ID 不泄露信息
6
https://api.example.com/users/69329847238479872
7
# 攻击者无法推断任何业务信息

1
-- MySQL 自增
2
CREATE TABLE users (
3
    id BIGINT AUTO_INCREMENT PRIMARY KEY
4
);
5

6
-- PostgreSQL 自增
7
CREATE TABLE users (
8
    id BIGSerial PRIMARY KEY
9
);

1
import uuid
2

3
# UUID v1：基于时间戳 + MAC 地址
4
uuid.uuid1()  # 550e8400-e29b-41d4-a716-446655440000
5

6
# UUID v4：完全随机
7
uuid.uuid4()  # 7c9e6679-7425-40de-944b-e07fc1f90ae7

1
# Twitter 雪花算法
2
class Snowflake:
3
    def __init__(self, worker_id, datacenter_id):
4
        self.worker_id = worker_id
5
        self.datacenter_id = datacenter_id
6
        self.sequence = 0
7
        self.last_timestamp = -1
8

9
    def generate(self):
10
        timestamp = int(time.time() * 1000)
11

12
        if timestamp == self.last_timestamp:
13
            self.sequence = (self.sequence + 1) & 4095
14
        else:
15
            self.sequence = 0
16

17
        self.last_timestamp = timestamp
18

19
        # 组装 ID
20
        return ((timestamp - 1288834974657) << 22) | \
21
               (self.datacenter_id << 17) | \
22
               (self.worker_id << 12) | \
23
               self.sequence

1
import ulid
2

3
# ULID：时间戳 + 随机数
4
ulid.ulid()  # 01ARZ3NDEKTSV4RRFFQ69G5FAV

1
# 单体应用：自增 ID 足够
2
class UserRepository:
3
    def create(self, name):
4
        return self.db.insert("users", {"name": name})  # 返回自增 ID
5

6
# 分布式应用：雪花算法
7
class DistributedUserRepository:
8
    def create(self, name):
9
        snowflake = Snowflake(worker_id=1, datacenter_id=1)
10
        user_id = snowflake.generate()
11
        return self.db.insert("users", {"id": user_id, "name": name})
12

13
# 多语言系统：UUID v4
14
class MultiLangUserRepository:
15
    def create(self, name):
16
        user_id = str(uuid.uuid4())
17
        return self.db.insert("users", {"id": user_id, "name": name})

1
-- 推荐做法：使用无意义 ID 作为主键，但保留业务唯一键
2
CREATE TABLE users (
3
    id BIGSERIAL PRIMARY KEY,           -- 无意义主键
4
    user_uuid UUID UNIQUE NOT NULL,     -- 外部暴露的 ID
5
    email VARCHAR(255) UNIQUE NOT NULL, -- 业务唯一键
6
    phone VARCHAR(20) UNIQUE,           -- 业务唯一键
7
    created_at TIMESTAMP DEFAULT NOW()
8
);
9

10
-- 索引策略
11
CREATE INDEX idx_users_uuid ON users(user_uuid);  -- 快速查找
12
CREATE INDEX idx_users_email ON users(email);     -- 业务查询

1
# 内部使用自增 ID
2
internal_id = 12345
3

4
# 外部暴露使用 UUID 或雪花 ID
5
public_id = uuid.uuid4()  # 6ba7b810-9dad-11d1-80b4-00c04fd430c8
6

7
# 或使用 base62 编码的雪花 ID
8
public_id = base62.encode(snowflake_id)  # 2VxNMwNMNMNMNMNMNMNMNM

1
# 内部表使用自增 ID
2
class User:
3
    __table__ = "users"
4
    __primary_key__ = "id"  # 自增
5

6
# 外部暴露 UUID
7
class UserPublic:
8
    __expose__ = ["uuid", "name"]  # 不暴露内部 ID