Phantom钱包签名交易异常排查：本地正常生产环境报错

问题背景 #

创建消息并引导用户完成签名的代码如下：

const anchorWallet = useAnchorWallet();

const createLoginSignature = async () => {
    if (!anchorWallet) return;

    const message = "AQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABAAECyIchCFWi8XOQK9v26xdqOA6+Nh0PxppQs5xbNaKQd78FSlNamSkhBk0k6HFg2jh8fDW13bySu4HkH6hAQQVEjevqUjJAYV5RMlecXJFT5t4nmfGtoU+AHeNooBntb74QAQEAxAJzb2xhbmEtd2ViMi1hdXRoLnZlcmNlbC5hcHAgd2FudHMgeW91IHRvIHNpZ24gaW4gd2l0aCB5b3VyIFNvbGFuYSBhY2NvdW50OgpFVm4zb2ZYaXZWTFJ3VXl5U2ZhVE02UmVuanZOTkhUeTM5VFpqMW91QWFITAoKU2lnbiBpbiB3aXRoIFNvbGFuYSB0byB0aGUgYXBwLgoKVVJJOiBodHRwczovL3NvbGFuYS13ZWIyLWF1dGgudmVyY2VsLmFwcApWZXJzaW9uOiAxCkNoYWluIElEOiAxCk5vbmNlOiBkNmJhYTAzMTMxZDEzOWIzZWRiMQpJc3N1ZWQgQXQ6IDIwMjItMTAtMjJUMTg6NDU6NDguOTczWgpFeHBpcmF0aW9uIFRpbWU6IDIwMjItMTAtMjJUMTk6NDU6NDguOTczWgo=";

    const tx = Transaction.from(Buffer.from(message, "base64"));

    const signTx = await anchorWallet.signTransaction(tx);

    const signedData = signTx.serialize().toString("base64");

    return signedData;
};

这段代码在本地环境运行正常，但部署到生产环境后出现报错：Phantom - RPC Error: Something went wrong. {code: -32603, message: 'Something went wrong.'}

本地成功弹窗截图：

生产环境失败弹窗截图：

原因分析及解决办法 #

1. 域名白名单未授权 #

Phantom钱包默认信任localhost这类本地域名，但生产环境域名必须手动添加到钱包的信任列表。如果用户没给生产域名授权，签名请求会被拦截。

• 处理方式：引导用户打开Phantom钱包，进入「设置」→「安全」→「网站权限」，找到你的生产域名并开启权限；或者在触发签名前提示用户检查授权状态。

2. 预编译消息的环境信息不匹配 #

你代码里的message是硬编码的Base64字符串，解码后包含固定的回调URL（https://solana-web2-auth.vercel.app），如果生产环境的实际域名和这个URL不一致，Phantom会判定为风险操作拒绝签名。

• 处理方式：不要硬编码签名消息，根据当前环境动态生成，确保消息里的域名、回调地址等信息和生产环境完全一致。

3. 未使用HTTPS协议 #

Phantom在生产环境强制要求网站使用HTTPS，HTTP环境下的签名请求会被安全机制拦截。

• 处理方式：确认生产环境已配置有效的HTTPS证书，确保网站通过HTTPS访问。

4. 钱包版本兼容性问题 #

不同版本的Phantom钱包对签名逻辑的处理可能有差异，用户生产环境使用的钱包版本可能和你本地测试的版本不兼容。

• 处理方式：建议用户将Phantom钱包升级到最新版本，同时测试代码在最新钱包版本下的运行情况。

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