Solana钱包连接报错：Cannot read properties of undefined (reading 'connect')

安全阿岳

2026-8-24

问题分析与解决方案

这个错误Cannot read properties of undefined (reading 'connect')本质是window.solana对象不存在了，和代码无关，大概率是浏览器钱包插件的运行异常。以下是具体排查和修复步骤：

1. 检查钱包插件状态

确认Phantom（或你使用的Solana钱包）插件是否在浏览器中正常启用，没有被禁用或崩溃
尝试关闭并重新打开钱包插件，或者重启浏览器

2. 验证钱包注入时机

钱包插件通常在页面加载完成后才会向window注入solana对象，插件异常可能导致注入延迟，建议在点击事件前增加判断：

$("#buttonContainer").click(function(){
    (async () => {
        try{
            if(!window.solana){
                alert("请先安装并启用Solana钱包插件");
                return;
            }
            var ownsNFT = false;
            const resp = await window.solana.connect();
            wallet = resp;
            localStorage.setItem('walletFinal',JSON.stringify(resp)); 
        } catch(err){
            console.error(err); 
        }
    })();
});

3. 修复localStorage存储问题

直接将connection和resp对象存入localStorage无效，因为localStorage仅支持字符串存储，对象会被转成[object Object]，无法还原：

// 存储连接信息时，只存RPC地址即可
localStorage.setItem('connectionWeb3', JSON.stringify(connection.rpcEndpoint));
// 读取时重建连接
const rpcEndpoint = localStorage.getItem('connectionWeb3');
const connection = new solanaWeb3.Connection(rpcEndpoint, 'confirmed');

// 存储钱包信息时，存公钥字符串即可
localStorage.setItem('walletFinal', JSON.stringify(resp.publicKey.toString()));