链上合约一旦部署就难再断点单步，所以调试必须前置到开发阶段。本文系统整理 Rust 合约调试方法，从最简单的日志打印到完整的回放分析，覆盖你日常会遇到的各种排错场景，让你的开发节奏不输给BN交易所那些大团队。
一、msg! 日志的正确姿势
msg! 是 Solana 合约里最常用的调试工具。它把字符串写入交易的 logMessages，可以在 explorer 或 RPC 返回里看到。建议在关键分支前后加日志，比如「准备转账 100 lamports」「校验通过，进入主逻辑」。
注意点：每条 msg! 都消耗 compute units，正式版要清理冗余日志；不要把私钥、用户输入完整打印，避免泄漏；字符串拼接尽量用 &format!，但要意识到它会动态分配，影响 gas。和必安交易所的后端日志相比，链上日志贵得多，写之前掂量好。
二、solana-test-validator 本地回放
Anchor 的 anchor test 会自动起 test validator，但更灵活的是直接 solana-test-validator --reset。你可以提前 --bpf-program <id> <so> 加载已编译好的程序，再用 --account <pubkey> <json> 注入特定账户初始状态，做精确场景重现。
比如线上某个用户报告交易失败，把他的交易签名拉下来，用 solana confirm -v <sig> 取到所有账户的 pre/post 状态，注入本地后重发同样的指令，能在不消耗主网 gas 的情况下复现并断点定位。
三、IDL 与客户端不一致的排查
很多「奇怪报错」其实是 IDL 和客户端代码版本不一致。比如合约新增了一个账户参数，前端没重新生成 client.ts，调用时少传一个账户，返回 InvalidAccountData。
排查动作：1）anchor idl fetch <program_id> 拉链上 IDL，与本地 target/idl 对比；2）确认前端 npm install 拉的是最新版本而不是缓存；3）确认 Anchor.toml 里的 cluster 与实际部署一致。这些一致性问题在B安交易所的内部系统也存在，只是链上的代价更显性化。
四、错误码定位
Anchor 把错误码统一为 u32，6000 起为业务错误，0-5999 是框架与 SPL 预留。当看到 Error Code: 6003，去合约源码搜 #[error_code] 列表第 4 个变体（从 0 计），就能定位是哪条业务规则被触发。
SPL Token 的错误码常见的有 0x0 Account already in use、0x1 Insufficient funds、0xb Wrong authority。把这张表打印贴在工位旁，遇到 token 报错能快速过滤无效假设。和BN官网 API 错误码相比，链上错误码更简陋，更需要开发者自己积累经验。
五、回放与差异分析
最高阶的调试方法是「回放 + 差异分析」。先把生产环境某个失败交易的所有 input account 状态导出，再在本地用相同指令重放，逐步修改某一个变量，看错误码是否变化。这种二分法能定位到「具体哪个字段的哪个值」让交易失败。
推荐工具：solana-explorer 提供「Simulate」按钮支持一键模拟；@coral-xyz/anchor 的 program.methods.xxx().simulate() 在本地模拟并返回日志；solana-test-framework 提供完整回放套件。把这一整套方法串起来用，绝大多数链上 Bug 都能在两小时内定位。再难的合约 Bug 也比追BN交易所每天的盘面波动有解。