Node.js使用Google Cloud Pub/Sub遇RangeError缓冲区越界问题

我在Node.js应用中集成Google Cloud Pub/Sub时，遇到了RangeError [ERR_BUFFER_OUT_OF_BOUNDS]: "length" is outside of buffer bounds错误。以下是服务的简化代码：

@Controller()
export class EventController {
    private subscription; 

    @Get('subscribe')
    public subscribe(): void {
        console.log('Subscribing to event');
        this.stringSubscriber.subscribe();
        console.log('Subscribed to event');
    }

    private stringSubscriber = {
        subscribe: (): void => {
            try {
                this.subscription.on('message', async (message: Message): Promise<void> => {
                    logger.info('[subscribe] [onMessage] message', {
                        message: message.data.toString(),
                        deliveryAttempt: message.deliveryAttempt,
                    });
                    await this.handleEvent({ message });
                });
            } catch (error) {
                logger.error('[subscribe] Error while subscribing', { error });
                throw error;
            }
        }
    };

    private async handleEvent(event: { message: Message }): Promise<void> {
        ....
    }
}

当我向Pod发送订阅请求时出现故障，但触发错误前已经打印了以下日志：

Subscribing to event.
Subscribed to event.

报错的堆栈信息如下：

node:events:498
       throw er; // Unhandled 'error' event
       ^
RangeError [ERR_BUFFER_OUT_OF_BOUNDS]: "length" is outside of buffer bounds
    at proto.utf8Write (node:internal/buffer:1066:13)
    at Op.writeStringBuffer [as fn] (file:///usr/app/apps/demo5/dist/dummy.js:38758:13)
    at BufferWriter.finish (file:///usr/app/apps/demo5/dist/dummy.js:38708:14)
    at file:///usr/app/apps/demo5/dist/dummy.js:45199:113
    at Array.map (<anonymous>)
    at createPackageDefinition (file:///usr/app/apps/demo5/dist/dummy.js:45199:41)
    at Object.fromJSON (file:///usr/app/apps/demo5/dist/dummy.js:45226:14)
    at _GrpcClient.loadProtoJSON (file:///usr/app/apps/demo5/dist/dummy.js:68212:51)
    at new IamClient (file:///usr/app/apps/demo5/dist/dummy.js:84620:37)
    at new SubscriberClient (file:///usr/app/apps/demo5/dist/dummy.js:88646:26)

我已经做了以下排查：

• 确认订阅已正确创建并初始化
• 验证消息处理逻辑正确，未引入缓冲区问题

解决方向 #

1. 检查SDK与Node.js版本兼容性
   该错误常与gRPC或Pub/Sub SDK版本冲突有关，尤其是Node.js版本和SDK要求不匹配时。尝试升级@google-cloud/pubsub到最新稳定版，同时确保Node.js版本符合SDK文档指定的最低要求。

2. 修复protobuf加载异常
   堆栈显示错误发生在createPackageDefinition和fromJSON阶段，说明构建后的代码中protobuf定义可能损坏，或依赖的protobuf库版本不一致。可以：

   • 清理node_modules和dist目录，重新安装依赖并构建项目
   • 执行npm ls protobufjs查看版本树，统一项目中protobuf相关包的版本

3. 添加未捕获错误监听
   错误提示为"Unhandled 'error' event"，说明subscription实例触发了error事件但未被监听。在订阅代码中补充监听逻辑，获取更详细的错误信息：

   this.subscription.on('error', (error) => {
       logger.error('[subscribe] Subscription error', { error });
   });
   

4. 验证环境配置与权限
   IamClient初始化异常可能间接引发该错误。确认Pod中的Google Cloud服务账号权限正确，GOOGLE_APPLICATION_CREDENTIALS等环境变量配置无误，确保应用能正常访问Pub/Sub服务。

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