Serverless+NestJS中fileTypeFromBuffer返回undefined问题排查

Buffer被错误转码（fileTypeFromBuffer返回undefined的核心原因） #

从你提供的buffer输出可以看到，PNG文件的魔数被错误修改：正常PNG开头应为89 50 4e 47，但你的buffer开头是c2 89 50 4e 47。这说明原始二进制数据被当成UTF-8字符串解析后重新编码，导致文件头被破坏，file-type无法识别有效文件签名。

修复步骤： #

• 启用Serverless Offline的二进制支持：在serverless.yml中添加自定义配置，确保本地开发时正确处理二进制请求：

  custom:
    serverless-offline:
      binary:
        enable: true
  

• 确认API Gateway的二进制配置生效：虽然你已经设置binaryMediaTypes: ['*/*']，但部署到AWS时需要确保API Gateway重新部署以应用该配置。

File-type动态导入的潜在问题 #

你通过eval动态导入file-type的方式，在Serverless打包后的生产环境中可能存在模块加载异常，导致fileTypeFromBuffer未正确初始化。

修复步骤： #

替换为静态导入，避免动态加载的不确定性：

import { fileTypeFromBuffer } from 'file-type';

// 直接调用
const fileType = await fileTypeFromBuffer(file.buffer);

Sharp跨平台二进制不兼容（图片处理失败的原因） #

你的serverless.yml中指定安装Mac（darwin/arm64）版本的Sharp，但AWS Lambda运行在Linux环境下，二进制文件不兼容，导致Sharp无法正确识别和处理图片。

修复步骤： #

根据Lambda使用的架构，修改Sharp的安装命令：

• 若Lambda使用x86_64架构：

  esbuild:
    external:
      - sharp
    packagerOptions:
      scripts:
        - npm install --platform=linux --arch=x64 sharp
  

• 若Lambda使用arm64架构（Graviton2）：

  esbuild:
    external:
      - sharp
    packagerOptions:
      scripts:
        - npm install --platform=linux --arch=arm64 sharp
  

同时在provider字段中明确指定架构（可选，确保与安装版本匹配）：

provider:
  name: aws
  runtime: nodejs20.x
  memorySize: 1024
  architecture: arm64 # 或x86_64

Multer存储配置验证 #

显式指定multer使用内存存储，确保文件buffer未被篡改：

import { FileInterceptor } from '@nestjs/platform-express';
import { memoryStorage } from 'multer';

@Post('upload/image')
@UseInterceptors(FileInterceptor('file', {
  storage: memoryStorage(), // 强制使用内存存储，避免磁盘存储带来的编码问题
}))
async uploadFile(
  // ... 其余代码保持不变
) {
  // ...
}

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