Proxy 实现属性访问日志的核心是拦截 get 和 set 操作并记录信息,需用 Reflect 保持原型链、规避内置方法触发递归、WeakMap 缓存防重复代理及循环引用。

用 Proxy 实现属性访问日志,核心是拦截 get 和 set 操作,在触发时打印或收集信息,无需手动修改每个属性的访问逻辑。
基础代理封装:拦截读写并打日志
创建一个通用函数,接收目标对象,返回带日志能力的代理对象:
- 使用
new Proxy(target, handler)包裹原对象 -
handler.get在每次读取属性时触发,可记录属性名、当前值、访问时间 -
handler.set在赋值时触发,记录属性名、旧值、新值、时间戳 - 注意在
set中要真正执行赋值(target[prop] = value),否则修改无效
避免无限递归:谨慎处理 getter 和 this 上下文
如果目标对象本身有 getter,或日志中访问了 this 相关属性(如 toString),可能引发代理嵌套调用导致栈溢出:
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
- 在
get拦截器中,对Symbol.toStringTag、toString、valueOf等内置方法直接返回原始行为,不打日志 - 用
Reflect.get(target, prop, receiver)替代target[prop],保持正确原型链和this绑定 - 日志内容尽量只用字符串拼接,避免触发额外属性访问(例如不要写
console.log('value:', obj.x))
支持嵌套对象:递归代理或按需代理
默认 Proxy 不会自动代理嵌套对象的属性访问。若需完整追踪,有两种常见做法:
立即学习“Java免费学习笔记(深入)”;
-
按需代理:在
get返回值为对象时,检查是否已代理过;未代理则新建 Proxy 并缓存,避免重复包装 - 浅层日志:只记录一级属性访问,适合调试结构简单或明确知道嵌套深度的场景
- 注意循环引用对象需加判断,防止无限代理(可用 WeakMap 缓存已代理对象)
实际使用示例:带配置的日志代理
下面是一个可复用的 createLoggedProxy 函数:
function createLoggedProxy(obj, options = {}) {
const { logger = console.log, includeMethods = false } = options;
const seen = new WeakMap();
function wrap(target) {
if (seen.has(target)) return seen.get(target);
if (target !== null && typeof target === 'object') {
const proxy = new Proxy(target, {
get(target, prop, receiver) {
if (!includeMethods && typeof target[prop] === 'function') return target[prop];
if (prop === 'toString' || prop === 'valueOf' || prop === Symbol.toStringTag) {
return Reflect.get(target, prop, receiver);
}
logger(`[GET] ${String(prop)} →`, Reflect.get(target, prop, receiver));
return Reflect.get(target, prop, receiver);
},
set(target, prop, value, receiver) {
const oldValue = target[prop];
const result = Reflect.set(target, prop, value, receiver);
logger(`[SET] ${String(prop)}:`, oldValue, '→', value);
return result;
}
});
seen.set(target, proxy);
return proxy;
}
return target;
}
return wrap(obj);
}
// 使用
const user = { name: 'Alice', age: 30, address: { city: 'Beijing' } };
const loggedUser = createLoggedProxy(user, { includeMethods: true });
loggedUser.name; // [GET] name → Alice
loggedUser.age = 31; // [SET] age: 30 → 31

















