FastAPI StreamingResponse返回音频无法播放无报错求助

以下是针对你代码的具体排查方向和修复建议：

1. 临时文件voice.wav的冲突与路径问题 #

你的代码每次处理请求都会生成同名的voice.wav文件，多并发请求会互相覆盖，导致返回的音频数据损坏或不完整。另外，程序当前的工作目录可能不是你预期的路径，导致文件实际未被正确写入或读取。

修复建议：

• 生成唯一的临时文件名，结合audio_id和user_id避免冲突：

  import os
  
  temp_file = f"voice_{user_id}_{audio_id}.wav"
  blob_to_wav(audio_data.audio_file, temp_file)  # 修改blob_to_wav支持指定输出路径
  def iterfile():
      with open(temp_file, mode="rb") as file_like:
          yield from file_like
      os.remove(temp_file)  # 读取完成后删除临时文件
  

• 或者直接在内存中处理音频数据，完全避免磁盘IO：如果blob_to_wav可以返回二进制数据，用BytesIO包装：

  from io import BytesIO
  
  audio_bytes = blob_to_wav(audio_data.audio_file)  # 修改函数返回二进制数据
  def iterfile():
      yield from BytesIO(audio_bytes)
  

2. 验证blob_to_wav的输出有效性 #

blob_to_wav函数可能没有正确将数据库中的blob转换为有效的WAV文件：

• 手动调用blob_to_wav生成文件，用本地音频播放器打开，确认文件是否能正常播放。
• 检查数据库中存储的blob数据是否完整，有没有在存储或转换过程中丢失字节。

3. 优化StreamingResponse的响应头 #

仅指定media_type='audio/wav'可能不足以让客户端正确识别音频，补充响应头可以提升兼容性：

return StreamingResponse(
    iterfile(),
    media_type='audio/wav',
    headers={"Content-Disposition": f"inline; filename=audio_{audio_id}.wav"}
)

Content-Disposition头可以明确告诉浏览器这是一个可直接播放的音频文件。

4. 扩大异常捕获范围 #

当前代码的try-except块没有覆盖权限验证后的部分逻辑，blob_to_wav的异常可能未被捕获：

• 将权限验证及后续逻辑全部纳入try块，确保所有潜在错误都能被捕获并返回明确的500错误：

  try:
      result = await check_access_token_expired(access_token=access_token)
      if result is True or result is False:
          return RedirectResponse(url=config.redirect_uri_page_masuk, status_code=401)
      user_id = result
  
      user = await userdata.filter(user_id=user_id).first()
      audio_data = await logaudio.filter(user_id=user_id, audio_id=audio_id).first()
      # 后续音频处理逻辑...
  except Exception as e:
      raise HTTPException(status_code=500, detail=str(e))
  

5. 确认音频格式与media_type匹配 #

如果数据库中的blob实际是其他格式（比如MP3），但你指定了media_type='audio/wav'，会导致客户端无法解析。可以用工具（如ffmpeg）检查生成的音频文件格式，调整对应media_type：

• MP3格式：media_type='audio/mpeg'
• OGG格式：media_type='audio/ogg'

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