HarmonyOS 7 InputEventMonitor 接入排错：注销没报错，监听为什么还在触发？

打开一个工具页，点一次鼠标只记一条事件；返回再进入，点一次却记两条。退出时明明调用了 removeLocalInputEventMonitor，也没有异常，为什么监听没有消失？

先不要把问题归到事件分发顺序。这个 API 的注销依据不是回调函数、页面名字或者自己写的 ownerId，而是注册时系统返回的原始 InputEventMonitor 对象。传入无效对象会被静默忽略，“没抛异常”因此不能证明注销成功。

本文用重复进入页面、同一应用的两个窗口两组案例，整理注册与释放的边界。目标是把监听关干净，同时保留普通控件的输入响应，不做跨应用键盘监听，也不把示例描述成已经发生的线上事故。

版本与验证：这些接口起始版本为 26.0.0，仅适用 Stage 模型。全局基础输入事件参考页更新于 2026-08-29 17:41，UIContext 参考页更新于 2026-09-23 10:54，本次核对日期2026-09-27。公共注册管理类和两组断言已在本机 Node.js 执行；ArkTS 页面未在 API 26 SDK 或真机编译运行。测试替身验证引用管理，不模拟系统输入分发。

文档叫“全局”，作用域却不是整个系统

addLocalInputEventMonitor 属于 UIContext。官方明确说明：监听只在当前 UIContext，也就是当前窗口内有效，不会响应其他 UIContext 实例。

它所处的位置是在事件到达具体组件之前，所以适合窗口级统一观察或输入过滤；并不是让一个普通页面拿到其他应用输入的接口。把一个 monitor 存到全局单例里，也不会自动扩大它的监听范围。

这里有四个必须一起看的定义：

定义	官方行为	接入时的选择
addLocalInputEventMonitor	返回系统创建的标识对象；无效参数可能返回 undefined	保留返回引用，检查注册是否成立
removeLocalInputEventMonitor	只接受注册返回的对象；无效对象静默忽略	不克隆、不序列化、不手动拼造句柄
InputEventListener	UI线程同步执行	只做简单判断，不在里面解析大数据、写文件或等网络
InputEventInterceptResult.action	CONTINUE继续分发；BLOCK阻止到UI框架	单纯观察时始终CONTINUE，不要误吞控件事件

InputEventMonitor 本身是没有可访问成员的标识对象。它不是可以随意保存成 JSON 的配置，更不是用 new 创建的业务类。应用自己的 ownerId 可以用来索引“谁持有这个句柄”，但不能代替句柄传给系统。

案例一：重复进入，只留下一个活动注册

先把注册动作封装成一个小类。它只保存原始引用，不知道鼠标或按键的细节，所以宿主端也能测试。acquire 重复调用不会重复注册；release 用的正是 acquire 保存的对象。注册返回 undefined 时不假装持有成功。

export class MonitorLease<T> {
  private handle: T | undefined = undefined;
  private add: () => T | undefined;
  private remove: (handle: T) => void;

  constructor(add: () => T | undefined, remove: (handle: T) => void) {
    this.add = add;
    this.remove = remove;
  }

  acquire(): boolean {
    if (this.handle !== undefined) return true;
    const created = this.add();
    if (created === undefined) return false;
    this.handle = created;
    return true;
  }

  release(): void {
    const current = this.handle;
    if (current === undefined) return;
    this.remove(current);
    this.handle = undefined;
  }

  get held(): boolean { return this.handle !== undefined; }
}

release 在 remove 返回后才清空引用，这样适配层若抛异常，还能保留信息进行排查。要注意，系统对无效对象的静默忽略没有成功回执；held=false 只表示应用释放了本地记录。真正的设备端验收仍然要触发输入，确认该监听回调不再执行。这个类保证自己传对对象，但不能替所有外部代码背书。

下面是使用鼠标左键按下事件的页面接入。MonitorLease.ets 与页面放在同一目录。鼠标掩码沿用官方已定义的 LEFT_MOUSE_DOWN；这里不凭名字猜测不存在的 KEYBOARD 枚举。

import { MonitorLease } from './MonitorLease';

@Entry
@Component
struct MonitorPage {
  private lease: MonitorLease<InputEventMonitor> | undefined = undefined;
  @State seen: number = 0;
  @State stateText: string = '未注册';

  private start(): void {
    if (this.lease === undefined) {
      const context = this.getUIContext();
      const listener: InputEventListener = (wrapper: RawInputEventWrapper) => {
        if (wrapper.isMouseEvent()) {
          const mouse = wrapper.asMouseEvent();
          if (mouse !== null) this.seen++;
        }
        return { action: InputEventInterceptAction.CONTINUE };
      };
      this.lease = new MonitorLease<InputEventMonitor>(
        () => context.addLocalInputEventMonitor(
          InputEventSubTypeMask.LEFT_MOUSE_DOWN, listener),
        (monitor: InputEventMonitor) => {
          context.removeLocalInputEventMonitor(monitor);
        }
      );
    }
    this.stateText = this.lease.acquire() ? '已注册' : '注册失败';
  }

  private stop(): void {
    if (this.lease !== undefined) {
      this.lease.release();
      this.lease = undefined;
    }
    this.stateText = '本地句柄已释放，请触发输入验证';
  }

  aboutToAppear(): void { this.start(); }
  aboutToDisappear(): void { this.stop(); }

  build() {
    Column({ space: 16 }) {
      Text(this.stateText)
      Text('观察到的鼠标按下次数：' + this.seen)
      Button('再次注册').onClick(() => { this.start(); })
      Button('停止监听').onClick(() => { this.stop(); })
    }.width('100%').height('100%')
  }
}

注册和注销闭包捕获同一个 context，避免注销时临时查到另一个窗口的上下文。这里用按钮触发两次注册，观察数量是否仍只有一份；点击停止按钮时，它自己的鼠标按下事件可能已经被观察到，因为监视器发生在具体组件处理之前。验收应看停止之后的下一次独立点击，而不是拿停止按钮这一击来误判。

示例用 seen 更新界面便于观察，只订阅低频的鼠标按下。扩展到移动事件时，不要每个事件都写 @State 或打印日志，应该用有界的轻量统计并控制展示刷新。把重工作放进 Promise.then 或 setTimeout，也不会自动把它移出 UI线程；真正需要后台处理时，应使用适合该工作的任务机制。

执行同一份管理类的回归测试

把下面代码接在 MonitorLease 后执行。FakeRegistry 只用对象引用模拟注册表，不是系统 InputEventMonitor 的替代实现。故意传一个新建对象，测试它不会移除真正的注册；随后让管理类释放原始对象。

class Token {}
class FakeRegistry {
  tokens: Set<Token> = new Set<Token>();
  additions: number = 0;
  add(): Token {
    const token = new Token();
    this.tokens.add(token);
    this.additions++;
    return token;
  }
  remove(token: Token): void { this.tokens.delete(token); }
}
function expect(value: boolean, message: string): void {
  if (!value) throw new Error(message);
}

const nativeA = new FakeRegistry();
const pageA = new MonitorLease<Token>(
  () => nativeA.add(), (token: Token) => nativeA.remove(token));
expect(pageA.acquire() && pageA.acquire(), 'repeated acquire');
expect(nativeA.additions === 1 && nativeA.tokens.size === 1, 'one active');
nativeA.remove(new Token());
expect(nativeA.tokens.size === 1, 'fabricated token cannot remove original');
pageA.release();
pageA.release();
expect(nativeA.tokens.size === 0 && !pageA.held, 'idempotent release');
expect(pageA.acquire(), 'can register after a completed release');
expect(nativeA.additions === 2 && nativeA.tokens.size === 1, 'new lifecycle');
pageA.release();
const failed = new MonitorLease<Token>(() => undefined, () => {});
expect(!failed.acquire() && !failed.held, 'registration failure stays unheld');
console.log('lifecycle case passed');

案例二：主窗口能响应，子窗口为什么没有事件？

如果输入发生在另一个 UIContext，主窗口的监听不响应是范围限制，不是注册丢了。不要在主窗口反复重试 add，最终只是把主窗口装了多份监听。

有两个选择：功能只服务主窗口，就保持主窗口注册；确实要在多个窗口内观察，则每个窗口分别注册，并各自保存 context 与 monitor。关掉其中一个窗口，只释放它自己的注册，不能用一个共享变量覆盖另一个窗口的句柄。

接着上一段测试运行下面断言，可以先检查应用的双窗口所有权模型：

const windowA = new FakeRegistry();
const windowB = new FakeRegistry();
const leaseA = new MonitorLease<Token>(
  () => windowA.add(), (token: Token) => windowA.remove(token));
const leaseB = new MonitorLease<Token>(
  () => windowB.add(), (token: Token) => windowB.remove(token));
leaseA.acquire();
leaseB.acquire();
expect(windowA.tokens.size === 1 && windowB.tokens.size === 1, 'two owners');
leaseA.release();
expect(windowA.tokens.size === 0, 'A released');
expect(windowB.tokens.size === 1 && leaseB.held, 'B unaffected');
leaseB.release();
expect(windowB.tokens.size === 0, 'B released separately');
console.log('window ownership case passed');

本机得到 lifecycle case passed 和 window ownership case passed。真实设备仍要分别在两个窗口内触发输入，确认当前窗口注册的响应边界，并关闭其中一个窗口验证另一个不受影响。普通单窗口手机页面不必为了测试凭空创建子窗，先完成第一组生命周期验收即可。

事件提前到达，也意味着有些字段现在还不能用

RawInputEventWrapper 包装鼠标、触摸或按键事件，通过 isMouseEvent/isTouchEvent/isKeyEvent 判断，再用对应 as 方法取对象。as 方法可能返回 null，不应该不分类型强行读取。

因为事件还没派发给具体组件，官方列出了不能提供有效值的部分：触发对象 target、相对于组件的 x/y、getCurrentLocalPosition、stopPropagation，TouchEvent 的 preventDefault/getHistoricalPoints，以及 KeyEvent 的 metaKey/getModifierKeyState。

因此“在这个回调里用组件局部坐标判断命中了哪个按钮”，或者“直接读 metaKey 判定组合键”，都不是可靠接法。鼠标示例可以读取 windowX/windowY，但窗口坐标不等于组件坐标。若需求本质上属于一个具体按钮，优先在该组件的正常事件里处理，既有正确上下文，也少一层窗口级拦截。

同时，阻止事件应返回 BLOCK，而不是在这里调用无效的 stopPropagation。观察型示例统一 CONTINUE。实现真正的输入屏蔽时，要设计完整事件序列，不能只吞掉 DOWN 却让后续 UP 或移动继续下传，造成控件状态不一致。

上线前最该做的四项检查

检查	操作	通过标准
重复注册	不离开页面，反复调用注册入口	活动注册只有一份
退出释放	离开后再次在该窗口输入	旧页面回调不再触发
多窗口隔离	A/B分别注册，关闭A	B正常，A的资源被释放
普通交互	注册后操作按钮、滚动和输入框	观察模式不吞事件，不改变正常行为

页面隐藏不一定等于组件销毁。如果使用缓存导航页，应把释放接到实际的页面失活策略，而不是认为所有返回操作都会触发 aboutToDisappear；需要跨页面存活的窗口级监听，则由窗口所有者管理，别让某个临时组件顺手注销它。

这个封装减少的是句柄丢失、重复注册和所有权混乱，不是声称单凭几行代码就提升帧率。遇到“注销没报错但还在触发”，先核对是不是原始句柄、是不是同一窗口、是不是还有另一份注册，再查回调工作量，排查会更有依据。

官方参考

• 全局基础输入事件监听：句柄、包装器与回调限制
• UIContext.addLocalInputEventMonitor：当前窗口与注册返回值
• UIContext.removeLocalInputEventMonitor：无效对象静默忽略