14.2使用「阿里云函数计算 FC」时遇到的三大常见问题和排查解决方案
查资料发现这三个方案覆盖了 99% 的对应问题场景按步骤操作即可快速解决。常见问题及解决办法速查问题现象解决方法函数报错 500检查 AK/SK 是否填对确认 OSS Bucket 名和地域正确音频无法播放检查 OSS 跨域配置确认录音文件为公共读访问弹下载检查代码中Response的content_type是否为text/html; charsetutf-8一、函数报错 500服务器内部错误问题原因500 是函数执行时抛出了未捕获异常核心原因集中在密钥错误、OSS 配置错误、权限不足、代码逻辑异常。完整解决方案按优先级排查检查 AccessKeyAK/SK配置错误场景AK/SK 填错、漏填、使用了过期 / 禁用的密钥、子账号无权限排查步骤登录阿里云控制台 → 右上角头像 →AccessKey 管理确认函数中配置的 AK/SK完全一致区分大小写不能有空格若使用子账号 AK必须给该账号授予OSS 读写权限AliyunOSSFullAccess 或自定义权限建议优先使用函数计算权限配置 / 角色不硬编码 AK/SK更安全检查 OSS Bucket 名称和地域错误场景Bucket 名称写错、地域填错如杭州写成上海、跨地域访问未配置排查步骤OSS 控制台 → 找到对应 Bucket → 概览页复制Bucket 名称不带后缀复制Endpoint 地域如杭州oss-cn-hangzhou.aliyuncs.com函数代码中必须严格使用复制的名称和地域不能手写错误检查函数日志定位具体报错函数计算控制台 → 对应函数 →日志查询查看报错堆栈NoSuchBucketBucket 名 / 地域错误AccessDeniedAK/SK 错误或无权限其他报错代码逻辑问题空指针、依赖缺失等补充排查函数运行环境是否安装了 OSS SDK如 Python oss2、Node alicloud/oss代码中是否捕获了异常未抛出导致 500二、音频无法播放浏览器 / 客户端播放失败问题原因音频文件存储在 OSS核心原因OSS 跨域CORS未配置、文件权限不是公共读、音频格式损坏、路径错误。完整解决方案配置 OSS 跨域规则最关键浏览器播放音频必须允许跨域否则会被拦截进入 OSS 对应 Bucket →权限管理→跨域设置→创建规则按以下配置填写通用最优配置来源*测试用/ 你的域名正式用允许 MethodsGET、OPTIONS允许 Headers*暴露 HeadersContent-Length,ETag缓存时间300保存规则等待 1 分钟生效设置音频文件为 公共读 权限OSS 找到音频文件 → 右键 →修改文件 ACL选择公共读私有权限会直接播放失败 / 403批量文件可在文件列表批量修改权限补充排查确认音频文件未损坏本地下载后能播放确认文件格式支持mp3、wav、m4a 为通用格式函数返回的音频 URL 是OSS 外网访问地址不是内网地址三、访问函数直接弹出文件下载不展示网页问题原因浏览器识别响应类型错误Response 响应头 Content-Type 配置错误浏览器默认当成文件下载。完整解决方案1、强制设置正确的 Content-Type函数返回响应时必须指定Content-Type: text/html; charsetutf-8✅ 正确配置以常见语言为例PythonHTTP 触发器def handler(event, context): return { statusCode: 200, headers: { Content-Type: text/html; charsetutf-8 # 必须这行 }, body: htmlbody测试页面/body/html }Node.jsexports.handler (event, context, callback) { const response { statusCode: 200, headers: { Content-Type: text/html; charsetutf-8 }, body: htmlbody测试页面/body/html }; callback(null, response); };2、排查错误配置错误写法Content-Type: application/json返回网页时会弹下载错误写法Content-Type: application/octet-stream二进制流强制下载漏写完全没有配置 Content-Type3、验证方法浏览器 F12 → Network → 查看响应头Response Headers必须看到Content-Type: text/html; charsetutf-8总结函数 500优先查 AK/SK、OSS Bucket 名 / 地域再看函数日志定位具体异常音频无法播放必须配置 OSS 跨域规则 文件公共读权限访问弹下载强制给响应头设置Content-Type: text/html; charsetutf-8
