TypeScript与Express应用中跨函数无法访问对象属性的问题

问题根源是httpIUploadImage函数的返回类型被TypeScript推断为Promise<Response | {url: string, publicId: string}>——因为函数内部存在多个返回分支：当无文件时返回res.status(404).json(...)（类型为Response），正常上传后返回自定义对象，catch分支也返回Response。这导致调用后imageResult可能是Response类型，而Response没有url属性，所以TypeScript报错。

方案一：重构函数为纯工具函数（推荐） #

将上传逻辑和响应处理分离，让httpIUploadImage只负责上传，抛出错误由调用方处理响应，这样函数返回类型明确：

1. 定义返回结果的类型接口：

interface UploadResult {
  url: string;
  publicId: string;
}

2. 修改httpIUploadImage函数：

export const httpIUploadImage = async (req: Request): Promise<UploadResult> => {
  const fileString = req?.file?.path;

  if (!fileString) {
    throw new Error('no image found');
  }

  try {
    const uploadResponse = await cloudinaryUpload(fileString);
    return {
      url: uploadResponse.secure_url,
      publicId: uploadResponse.public_id
    };
  } catch (err) {
    throw new Error(err instanceof Error ? err.message : '图片上传失败');
  }
};

3. 在调用方处理错误和响应：

export const httpCreateCategory = async (req: Request, res: Response) => {
  try {
    const imageResult = await httpIUploadImage(req);
    const url = imageResult.url; // 此处无类型错误
    // 继续执行分类创建的业务逻辑
  } catch (err) {
    if (err instanceof Error) {
      const statusCode = err.message === 'no image found' ? 404 : 500;
      return res.status(statusCode).json(err.message);
    }
    res.status(500).json('未知错误');
  }
};

方案二：保留原函数结构，添加类型守卫 #

如果不想重构函数，可在调用时通过类型守卫判断返回值类型：

export const httpCreateCategory = async (req: Request, res: Response) => {
  const imageResult = await httpIUploadImage(req, res);
  
  // 类型守卫：检查是否包含url属性
  if ('url' in imageResult) {
    const url = imageResult.url; // 此处类型正确
    // 后续业务逻辑
  }
  // 若返回的是Response，函数内部已处理响应，无需额外操作
};

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