设备无法设置JavaScript Cookie的故障排查与调试咨询

你提供的测试代码本身无语法错误，同一份示例在其他设备可正常运行，说明问题出在设备或浏览器的环境配置上，按以下优先级从高到低排查：

问题复现代码 #

<!DOCTYPE html>  
<html>  
<head>  
</head>  
<body>  
<input type="button" value="setCookie" onclick="setCookie()">  
<input type="button" value="getCookie" onclick="getCookie()">
    <script>  
    function setCookie()  
    {  
        document.cookie="username=Duke Martin";  
    }  
    function getCookie()  
    {  
        if(document.cookie.length!=0)  
        {  
        alert(document.cookie);  
        }  
        else  
        {  
        alert("Cookie not available");  
        }  
    }  
    </script>  
</body>  
</html>

排查步骤 #

1. 检查页面访问协议 #

这是本地测试Cookie失效最常见的原因：

• 如果你是直接双击本地HTML文件，通过file://协议打开页面，所有现代浏览器（Chrome、Edge、Firefox等）默认都会限制该协议下的Cookie写入权限，操作会被静默拦截，不会抛出显式报错。
• 解决方案：在HTML文件所在目录启动本地静态服务后再测试，比如安装Python后在当前目录执行命令python -m http.server 8000，之后在浏览器访问http://localhost:8000/对应文件名.html即可，也可以使用VS Code的Live Server插件快速启动本地服务。

2. 检查浏览器Cookie相关配置 #

• 打开浏览器的隐私和安全设置页，确认未开启「阻止所有Cookie」选项，同时检查localhost或你测试用的域名是否被加入Cookie阻止名单。
• 不要在无痕/隐私浏览窗口测试：部分浏览器的隐私模式默认会严格限制Cookie写入，甚至会话级Cookie也会被隔离，无法正常读取。
• 检查是否开启了「关闭浏览器即自动清除所有Cookie和站点数据」的配置，这类配置会导致Cookie写入后被立刻清除，表现为写入失败。

3. 排查拦截类软件的影响 #

• 先排查浏览器扩展：广告拦截、隐私保护、脚本拦截、Cookie自动清理类扩展经常会拦截Cookie写入操作，启动浏览器的无扩展安全模式测试，如果安全模式下功能正常，逐个禁用扩展定位拦截源即可。
• 再排查系统层面软件：暂时退出杀毒软件的网页防护模块、系统级广告拦截工具、带隐私过滤功能的VPN/代理，这类工具可能在系统层拦截Cookie操作。

4. 用开发者工具定位根因 #

如果以上步骤排查后仍无法解决，通过浏览器开发者工具精准定位问题：

• 按F12打开开发者工具，切换到Console面板，直接执行document.cookie = "test=debug123"，观察是否抛出SecurityError类的权限报错，报错信息会直接说明拦截原因。
• 切换到Application面板（Chrome/Edge）或存储面板（Firefox），左侧找到Cookie分类，选中当前测试的源，执行写入操作后观察面板中是否出现对应Cookie条目，确认是否存在写入后被立刻清除的情况。

说明：你测试的是会话级Cookie，不需要额外配置path、domain、SameSite属性，在正常的HTTP/HTTPS源下直接给document.cookie赋值即可生效，不需要反复修改测试代码。

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