将 @google-cloud/storage 从 8.x 升级到 9.x

根据 TypeScript 类型自动比较 @google-cloud/storage 8.4.0 与 9.0.0 的公开 API。签名变化表示可能存在不兼容变更，并非确定结论。

概要

已删除的导入路径	0
已删除的导出	1
已修改的签名	2
已删除的类或接口成员	36
已修改的类或接口成员	16
新增弃用	0
要求变化（engines、peer 依赖）	0
新增导出	0

已删除的导出

import	export	kind	之前
`@google-cloud/storage`	`ApiError`	class	`class`

已修改的签名

export	之前	之后
`@google-cloud/storage · GetBucketsResponse`	`[Bucket[], {}, unknown]`	`[Bucket[], unknown]`
`@google-cloud/storage · RETRYABLE_ERR_FN_DEFAULT`	`(err?: ApiError \| undefined): boolean`	`(err?: any): boolean`

已删除的类或接口成员

member	import	之前
`Iam.request_`	`@google-cloud/storage`	`any`
`Iam.resourceId_`	`@google-cloud/storage`	`any`
`File.request`	`@google-cloud/storage`	`(reqOpts: DecorateRequestOptions): Promise<RequestResponse> \| (reqOpts: DecorateRequestOptions, callback: BodyResponseCallback): void`
`File.request_`	`@google-cloud/storage`	`any`
`File.requestStream`	`@google-cloud/storage`	`(reqOpts: DecorateRequestOptions): TeenyRequest`
`File.getRequestInterceptors`	`@google-cloud/storage`	`(): Function[]`
`Bucket.request`	`@google-cloud/storage`	`(reqOpts: DecorateRequestOptions): Promise<RequestResponse> \| (reqOpts: DecorateRequestOptions, callback: BodyResponseCallback): void`
`Bucket.request_`	`@google-cloud/storage`	`any`
`Bucket.requestStream`	`@google-cloud/storage`	`(reqOpts: DecorateRequestOptions): TeenyRequest`
`Bucket.getRequestInterceptors`	`@google-cloud/storage`	`(): Function[]`
`Channel.request`	`@google-cloud/storage`	`(reqOpts: DecorateRequestOptions): Promise<RequestResponse> \| (reqOpts: DecorateRequestOptions, callback: BodyResponseCallback): void`
`Channel.request_`	`@google-cloud/storage`	`any`
`Channel.requestStream`	`@google-cloud/storage`	`(reqOpts: DecorateRequestOptions): TeenyRequest`
`Channel.getRequestInterceptors`	`@google-cloud/storage`	`(): Function[]`
`HmacKey.request`	`@google-cloud/storage`	`(reqOpts: DecorateRequestOptions): Promise<RequestResponse> \| (reqOpts: DecorateRequestOptions, callback: BodyResponseCallback): void`
`HmacKey.request_`	`@google-cloud/storage`	`any`
`HmacKey.requestStream`	`@google-cloud/storage`	`(reqOpts: DecorateRequestOptions): TeenyRequest`
`HmacKey.getRequestInterceptors`	`@google-cloud/storage`	`(): Function[]`
`Storage.request`	`@google-cloud/storage`	`(reqOpts: DecorateRequestOptions, callback: BodyResponseCallback): void`
`Storage.timeout`	`@google-cloud/storage`	`number \| undefined`
`Storage.request_`	`@google-cloud/storage`	`any`
`Storage.authClient`	`@google-cloud/storage`	`GoogleAuth<AuthClient>`
`Storage.packageJson`	`@google-cloud/storage`	`any`
`Storage.getProjectId`	`@google-cloud/storage`	`(): Promise<string> \| (callback: (err: Error \| null, projectId?: string \| undefined) => void): void`
`Storage.requestStream`	`@google-cloud/storage`	`(reqOpts: DecorateRequestOptions): Request`
`Storage.getProjectIdAsync`	`@google-cloud/storage`	`(): Promise<string>`
`Storage.projectIdRequired`	`@google-cloud/storage`	`any`
`Storage.providedUserAgent`	`@google-cloud/storage`	`string \| undefined`
`Storage.globalInterceptors`	`@google-cloud/storage`	`any`
`Storage.getRequestInterceptors`	`@google-cloud/storage`	`(): Function[]`
`Storage.makeAuthenticatedRequest`	`@google-cloud/storage`	`(reqOpts: DecorateRequestOptions): Duplexify \| (reqOpts: DecorateRequestOptions, options?: MakeAuthenticatedRequestOptions \| undefined): void \| Abortable \| (reqOpts: DecorateRequestOptions, callback?: BodyResponseCallback \| undefined): void \| Abortable \| (reqOpts: DecorateRequestOptions, optionsOrCa…`
`AclOptions.request`	`@google-cloud/storage`	`(reqOpts: DecorateRequestOptions, callback: BodyResponseCallback): void`
`Notification.request`	`@google-cloud/storage`	`(reqOpts: DecorateRequestOptions): Promise<RequestResponse> \| (reqOpts: DecorateRequestOptions, callback: BodyResponseCallback): void`
`Notification.request_`	`@google-cloud/storage`	`any`
`Notification.requestStream`	`@google-cloud/storage`	`(reqOpts: DecorateRequestOptions): TeenyRequest`
`Notification.getRequestInterceptors`	`@google-cloud/storage`	`(): Function[]`

已修改的类或接口成员

member	之前	之后
`File.delete`	`(options?: DeleteOptions \| undefined): Promise<[TeenyResponse]> \| (options: DeleteOptions, callback: DeleteCallback): void \| (callback: DeleteCallback): void`	`(options?: DeleteOptions \| undefined): Promise<[GaxiosResponse]> \| (options: DeleteOptions, callback: DeleteCallback): void \| (callback: DeleteCallback): void`
`File.interceptors`	`Interceptor[]`	`GaxiosInterceptor<GaxiosOptionsPrepared>[]`
`File.startSimpleUpload_`	`(dup: Duplexify, options?: CreateWriteStreamOptions \| undefined): void`	`(dup: Duplexify, options?: any): void`
`Bucket.delete`	`(options?: DeleteOptions \| undefined): Promise<[TeenyResponse]> \| (options: DeleteOptions, callback: DeleteCallback): void \| (callback: DeleteCallback): void`	`(options?: DeleteOptions \| undefined): Promise<[GaxiosResponse]> \| (options: DeleteOptions, callback: DeleteCallback): void \| (callback: DeleteCallback): void`
`Bucket.interceptors`	`Interceptor[]`	`GaxiosInterceptor<GaxiosOptionsPrepared>[]`
`Channel.delete`	`(options?: DeleteOptions \| undefined): Promise<[TeenyResponse]> \| (options: DeleteOptions, callback: DeleteCallback): void \| (callback: DeleteCallback): void`	`(options?: DeleteOptions \| undefined): Promise<[GaxiosResponse]> \| (options: DeleteOptions, callback: DeleteCallback): void \| (callback: DeleteCallback): void`
`Channel.interceptors`	`Interceptor[]`	`GaxiosInterceptor<GaxiosOptionsPrepared>[]`
`HmacKey.delete`	`(options?: DeleteOptions \| undefined): Promise<[TeenyResponse]> \| (options: DeleteOptions, callback: DeleteCallback): void \| (callback: DeleteCallback): void`	`(options?: DeleteOptions \| undefined): Promise<[GaxiosResponse]> \| (options: DeleteOptions, callback: DeleteCallback): void \| (callback: DeleteCallback): void`
`HmacKey.interceptors`	`Interceptor[]`	`GaxiosInterceptor<GaxiosOptionsPrepared>[]`
`Storage.projectId`	`string`	`string \| undefined`
`Storage.interceptors`	`Interceptor[]`	`GaxiosInterceptor<GaxiosOptionsPrepared>[]`
`AclMetadata.projectTeam`	`{ projectNumber?: string \| undefined; team?: "editors" \| "owners" \| "viewers" \| undefined; } \| undefined`	`{ projectNumber?: string \| undefined; team?: string \| undefined; } \| undefined`
`Notification.delete`	`(options?: DeleteOptions \| undefined): Promise<[TeenyResponse]> \| (options: DeleteOptions, callback: DeleteCallback): void \| (callback: DeleteCallback): void`	`(options?: DeleteOptions \| undefined): Promise<[GaxiosResponse]> \| (options: DeleteOptions, callback: DeleteCallback): void \| (callback: DeleteCallback): void`
`Notification.interceptors`	`Interceptor[]`	`GaxiosInterceptor<GaxiosOptionsPrepared>[]`
`StorageOptions.interceptors_`	`Interceptor[] \| undefined`	`GaxiosInterceptor<GaxiosOptionsPrepared>[] \| undefined`
`AccessControlObject.projectTeam`	`string`	`{ projectNumber?: string \| undefined; team?: string \| undefined; } \| undefined`

新增弃用

未发现。

要求变化（engines、peer 依赖）

未发现。

把这些数据交给你的 AI 智能体

Vigia 是免费的 MCP 服务器：你的编程智能体在写代码之前就能检查版本、不兼容变更和安全漏洞。无需注册，无需 API 密钥。

claude mcp add --transport http vigia https://vigia.coredls.cloud/mcp

添加到 Cursor 添加到 VS Code ★ 在 GitHub 上加星

任何其他 MCP 客户端

{ "mcpServers": { "vigia": { "url": "https://vigia.coredls.cloud/mcp" } } }

智能体技能（SKILL.md）：告诉智能体何时使用 Vigia · 用于拉取请求的 GitHub Action

常见问题

将 @google-cloud/storage 从 8 升级到 9 有哪些不兼容变更？

在 @google-cloud/storage 8.4.0 与 9.0.0 之间，Vigia 发现 1 个已删除的导出、2 个已修改的签名，以及 52 个已删除或修改的类或接口成员。

@google-cloud/storage 9 中弃用了哪些内容？

@google-cloud/storage 9.0.0 中有 0 个导出或成员新被标记为弃用。

供智能体使用

GET https://vigia.coredls.cloud/v1/packages/npm/@google-cloud/storage/upgrade?from=8.4.0&to=9.0.0