App端水印必须用原生层实现,因WebView无法覆盖整个窗口;需通过原生插件在UIWindow(iOS)或DecorView(Android)顶层绘制,推荐使用watermark-plus插件,并由服务端生成带签名的水印文本以确保防伪。

App端水印必须用原生层,WebView层加不了
uni-app 的 web-view 和普通 view 组件在 iOS/Android 原生容器里是渲染在不同图层的:前端 DOM 层无法盖住原生导航栏、状态栏,更没法穿透到整个 App 窗口。所以用 CSS 旋转 + position: fixed 在页面里“模拟”水印,只对内容区生效,截屏、录屏、截图分享时全失效。
真正起作用的水印,得由原生侧在窗口最顶层绘制——也就是通过原生插件(iOS/Android)把文字/图片以半透明方式画在 UIWindow(iOS)或 DecorView(Android)上。
- uni-app 官方不提供内置水印 API,必须自己写或集成第三方原生插件
- 插件需同时支持 iOS 和 Android,且要处理横竖屏旋转、键盘弹出导致的视图重绘问题
- 水印文字建议用 Base64 字体或系统默认字体,避免字体缺失导致空白
推荐用 uni-app 原生插件方案:watermark-plus
社区已有较成熟的开源插件 watermark-plus,封装了双端原生水印逻辑,调用简单,支持动态更新内容和样式。
安装后,在需要启用水印的页面 onLoad 中调用:
const watermark = uni.requireNativePlugin('watermark-plus');
watermark.setWatermark({
text: '内部资料',
fontSize: 16,
alpha: 0.12,
rotate: -25,
color: '#999'
});
-
text必须是字符串,不能传变量引用(原生侧不监听 JS 变量变化) -
alpha建议设为0.10–0.15,太低看不见,太高影响阅读 - Android 端若发现水印偏移,大概率是未适配刘海屏或全面屏,需在插件中调用
getRealSize获取真实屏幕尺寸
自定义水印内容需防篡改,别只靠前端拼接
很多人把水印文字写死在 JS 里,比如 text: this.userInfo.name + ' ' + new Date().toLocaleDateString(),这毫无防伪意义——用户禁用 JS 或抓包改响应就能绕过。
- 真实防伪水印的文本应由服务端生成并签名,例如返回
{text: '张三_20240521_xxxhash'},前端只负责透传给原生插件 - 原生插件收到后应校验 hash 后再渲染,否则可能被 hook 替换参数
- 若业务要求每个用户水印不同,务必在登录成功后、首页加载前就调用一次水印设置,避免白屏期无覆盖
关闭水印的时机容易漏,尤其在 tab 切换或登录态变更时
水印一旦绘制到原生窗口,不会随 Vue 页面卸载自动消失。如果用户从「我的资料」页(带水印)切到「公开介绍」页(不该有),水印还在。
- 必须在页面
onUnload或onHide中显式调用watermark.clearWatermark() - 使用
uni.switchTab时,目标页的onLoad触发晚于当前页onUnload,所以清除动作要放在onHide更稳妥 - 退出登录后,除了清空 token,还得立即清除水印,否则残留的旧用户名仍显示在锁屏界面或后台预览图上
uni.requireNativePlugin 调用里。没原生能力,再花哨的前端方案都只是纸糊的防伪。


















