Chrome扩展Manifest V3中downloads.open触发用户手势要求错误排查

出现Unchecked runtime.lastError: User gesture required错误的核心原因如下：

1. 用户手势上下文丢失：chrome.downloads.open是在下载完成的异步回调中执行的，此时距离用户触发confirm的手势已经超出Chrome的用户手势有效时间窗口——Chrome的用户手势验证仅在触发手势的同步调用栈或极短时间范围内有效，异步事件（如下载完成）触发时已无有效手势上下文。
2. 事件监听重复绑定：每次右键菜单点击都会新增chrome.runtime.onMessage和chrome.downloads.onChanged监听，导致逻辑混乱，可能触发重复操作。
3. 下载完成监听参数错误：chrome.downloads.onChanged的回调参数是delta对象，下载ID需通过delta.id获取，而非直接使用参数名downloadId。

通过调整逻辑，将下载与打开操作绑定到用户手势的有效时间窗口内，同时简化代码结构：

修正后的background.js #

chrome.contextMenus.create({
    id: "reg",
    title: "Open link",
    contexts: ["link"]
});

// 仅绑定一次消息监听，避免重复注册
chrome.runtime.onMessage.addListener((request, sender) => {
    if (request.action === 'handleDownload') {
        chrome.downloads.download({
            url: request.linkUrl,
            // 直接在下载请求中设置完成后是否自动打开，复用用户手势上下文
            openWhenCompleted: request.shouldOpen
        }, (downloadId) => {
            if (chrome.runtime.lastError) {
                console.error(chrome.runtime.lastError);
            }
        });
    }
});

chrome.contextMenus.onClicked.addListener((info, tab) => {
    chrome.scripting.executeScript({
        target: { tabId: tab.id, frameIds: [info.frameId] },
        func: () => {
            const shouldOpen = confirm("hello");
            chrome.runtime.sendMessage({
                action: 'handleDownload',
                linkUrl: info.linkUrl,
                shouldOpen
            });
        }
    });
});

简化myscript.js（可选） #

如果采用上述func内联执行的方式，可以直接删除myscript.js；若仍需保留独立脚本，修改为：

const shouldOpen = confirm("hello");
chrome.runtime.sendMessage({
    action: 'handleDownload',
    linkUrl: window.location.href,
    shouldOpen
});

• 利用chrome.downloads.download的openWhenCompleted参数，将打开操作与发起下载的用户手势上下文绑定，避免异步回调丢失手势权限。
• 统一消息监听逻辑，仅注册一次，防止重复触发。
• 移除冗余的chrome.downloads.onChanged监听，简化流程。

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