订单发票日志须单独建order_invoices表，含invoice_no、invoice_type、amount、tax_amount、status等核心字段；写入时机为税控接口成功返回后，事务内完成；状态单向流转且禁删，通过审计日志和定时对账保障一致性。
订单日志中记录发票信息的关键字段怎么设计
发票不是可选附加项，而是财务合规的强约束数据。直接在订单主表加字段会破坏范式、拖慢查询，也难以支持多发票（如分批开票）、红冲、作废等场景。必须单独建 order_invoices 表，并通过外键关联 order_id。
核心字段至少包括：invoice_no（发票代码+号码拼接，唯一索引）、invoice_type（如 "VAT" / "PLAIN"）、amount（开票金额，decimal(12,2)）、status（"issued" / "cancelled" / "red"）、created_at 和 updated_at。别漏掉 tax_rate 和 tax_amount —— 有些地区要求日志里精确拆分税额。
PHP 代码里什么时候写入发票日志最安全
不能在用户点击“申请开票”时就插入数据库。那只是请求，不是结果。真正落库时机必须是调用开票接口成功、拿到税控系统返回的 invoice_no 和签名后。
- 使用事务包裹：先更新订单状态为
"invoice_requested"，再调第三方开票 SDK，成功后再插入order_invoices并更新订单为"invoice_issued" - 捕获具体异常：比如税控平台返回
"INVALID_TAX_ID"或"QUOTA_EXCEEDED"，这些要原样记进日志表的error_message字段，而不是笼统抛Exception - 避免重复提交：在插入前用
INSERT ... ON DUPLICATE KEY UPDATE或先SELECT FOR UPDATE锁住订单行
如何防止发票日志被篡改或误删
发票数据属于审计证据，PHP 层不能提供任何删除或修改入口。所有变更只能是追加或状态变更。
立即学习“PHP免费学习笔记（深入）”；
-
status字段只允许单向流转："draft" → "issued"、"issued" → "red"、"issued" → "cancelled"，禁止回退 - 删除操作必须禁用：MySQL 层对
order_invoices表撤掉DELETE权限，只保留INSERT和有限UPDATE - 敏感操作留痕：每次状态变更都额外写一条审计日志到独立表
invoice_audit_logs，包含操作人 ID、IP、时间、旧状态、新状态
$pdo->prepare("INSERT INTO order_invoices (order_id, invoice_no, invoice_type, amount, tax_amount, status, created_at) VALUES (?, ?, ?, ?, ?, 'issued', NOW())")->execute([$orderId, $invoiceNo, $type, $amount, $taxAmount]);
查发票日志时为什么总漏数据
常见错误是 JOIN 订单表时用了 LEFT JOIN 却没意识到：一张订单可能还没开票，但业务方想看“所有订单 + 对应发票（如有）”。这时应该用 LEFT JOIN order_invoices，但 WHERE 条件里不能写 oi.status = 'issued' —— 这会把没开票的订单也过滤掉。
正确写法是把状态条件移到 ON 子句：
SELECT o.order_no, oi.invoice_no, oi.amount, oi.status
FROM orders o
LEFT JOIN order_invoices oi ON o.id = oi.order_id AND oi.status IN ('issued', 'red');
另外注意时区：PHP 写入用 date('Y-m-d H:i:s')（服务器时区），但财务系统可能要求 UTC 时间戳，日志字段类型建议统一用 DATETIME 并在应用层明确时区转换逻辑。
