Chrome插件开发求助：报错‘无活跃标签页可发送消息’

问题诊断 #

你的插件报错核心原因有三点：

• 仅查询当前窗口的活跃标签，若目标网站标签在其他窗口或未处于活跃状态，无法匹配到符合条件的标签
• 仅在标签更新至complete状态时发送消息，但如果标签已经加载完成，监听不会触发，消息无法送达
• URL匹配字符串格式错误，"https://[removed by me.](/")是无效前缀，无法正确识别目标网站

具体修复步骤 #

1. 扩展标签查询范围
   不要局限于当前窗口的活跃标签，直接查询所有打开的目标网站标签：将chrome.tabs.query的参数从{active: true, currentWindow: true}改为{url: "https://your-target-site.com/*"}（替换为实际目标网站的URL规则）。

2. 处理标签已加载完成的场景
   先检查标签当前状态，若已处于complete则直接发送消息，否则添加onUpdated监听等待加载完成。

3. 修正URL匹配逻辑
   将url.startsWith中的无效字符串替换为正确的目标网站前缀，比如"https://target-site.com/"。

修改后的background.js代码 #

let isBotRunning = false;

chrome.runtime.onMessage.addListener((message, _sender, sendResponse) => {
    if (message.action === "toggleBot") {
        isBotRunning = !isBotRunning;
        sendResponse({status: isBotRunning});

        // 查询所有打开的目标网站标签，替换为实际的目标网站URL规则
        chrome.tabs.query({url: "https://your-target-site.com/*"}, function(tabs) {
            if (tabs.length > 0) {
                tabs.forEach(tab => {
                    if (tab.id === undefined) return;
                    
                    // 检查标签是否已加载完成
                    if (tab.status === 'complete') {
                        sendBotMessage(tab.id);
                    } else {
                        // 添加监听等待标签加载完成
                        chrome.tabs.onUpdated.addListener(function listener(tabId, info) {
                            if (tabId === tab.id && info.status === 'complete') {
                                chrome.tabs.onUpdated.removeListener(listener);
                                sendBotMessage(tabId);
                            }
                        });
                    }
                });
            } else {
                console.error("No active tab found to send message to. Please navigate to a compatible website.");
            }
        });
    } else if (message.action === "queryStatus") {
        sendResponse({status: isBotRunning});
    }
});

// 封装发送消息的函数，避免重复代码
function sendBotMessage(tabId) {
    chrome.tabs.sendMessage(tabId, {
        action: isBotRunning ? "startBot" : "stopBot", // 建议将toggleBot改为stopBot，逻辑更清晰
        status: isBotRunning
    }).catch(error => {
        console.error("Error sending message:", error);
    });
}

额外排查点 #

• 确认manifest.json中的host_permissions包含目标网站，例如：

  "host_permissions": [
      "https://your-target-site.com/*"
  ]
  

• 再次检查chrome://discards/中目标网站标签的状态，确保没有被丢弃
• 在插件管理页面的「站点访问权限」中，确认插件已被授予访问目标网站的权限

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