Next 14 出现 'Extra attributes from the server: bis_register' 警告求助
解决Next.js 14中“Extra attributes from the server: bis_register”警告
这个警告并非你的代码或项目配置问题,它是Chrome浏览器的**生物识别注册API(Biometric Registration API)**相关实验性特性,或是第三方浏览器扩展注入属性导致的——浏览器会自动给DOM元素添加bis_register属性,而Next.js的客户端 hydration 过程中检测到服务端未生成该属性,因此抛出警告。
以下是具体解决步骤:
1. 排查浏览器扩展
- 禁用所有浏览器扩展,重启浏览器后重新启动开发服务,观察警告是否消失。
- 若警告消失,逐个启用扩展,定位到导致问题的扩展(通常是密码管理、生物识别相关工具),要么禁用该扩展,要么更新到最新版本。
2. 关闭Chrome的实验性特性
- 在Chrome地址栏输入
chrome://flags/#web-authentication-biometric-registration - 将“Web Authentication Biometric Registration”选项设置为 Disabled
- 重启浏览器后重新启动开发服务,警告即可消除。
3. 开发环境临时抑制警告(可选)
如果暂时无法修改浏览器配置,可通过Next.js编译器配置过滤该属性:
在项目根目录的next.config.js中添加如下配置:
/** @type {import('next').NextConfig} */ const nextConfig = { reactStrictMode: true, compiler: { reactRemoveProperties: { properties: ['bis_register'], }, }, } module.exports = nextConfig
保存后重启开发服务,警告会被自动过滤。注意:此方法仅适合开发环境临时使用,生产环境无需配置。
内容的提问来源于stack exchange,提问作者Redux Zmbs
相关产品推荐
相关产品推荐

