Azure WebApp中Streamlit下载功能突发持续故障排查求助

1. Streamlit会话状态丢失导致二进制数据失效 #

你的代码中，binary_summary是在「Generate entire Summary deck」按钮的回调块（if result:）内定义的。Streamlit的每次交互（包括点击下载按钮）都会重新运行整个脚本：

• 点击Generate按钮时，脚本执行到if result:块，生成binary_summary并渲染下载按钮
• 点击下载按钮时，脚本重新执行，此时result为False，binary_summary未被定义，下载按钮调用binary_summary.getvalue()会抛出异常，导致下载失败并生成无效的.bin链接

解决方向：将binary_summary存入Streamlit的会话状态（st.session_state）中，确保跨交互保留数据：

with col1:
    result = st.button("Generate entire Summary deck")
if result:
    t1 = pd.Timestamp.now()
    st.write(f'Started at {str(pd.Timestamp.now().time())}')
    subprocess.run(["Rscript", "summary_fcn.R", quarter])

    prs = summary_fcn.create_summary_ppt(quarter)
    # 存入会话状态
    st.session_state.binary_summary = BytesIO()
    prs.save(st.session_state.binary_summary) 
    st.session_state.binary_summary.seek(0)  # 重置流指针到开头
    st.write(f'generated in {str(pd.Timestamp.now()-t1)}')
with col2:
    # 检查会话状态中存在数据时才显示下载按钮
    if "binary_summary" in st.session_state:
        st.download_button(label = 'Download Summary',
                       data = st.session_state.binary_summary.getvalue(),
                       file_name = f'Summary_{quarter}_{str(pd.Timestamp.now())[2:-7].replace("-","").replace(" ","_").replace(":","")}.pptx')

2. BytesIO流指针位置异常 #

虽然getvalue()可以获取流的全部内容，但部分PPT库在save()后会将流指针移到末尾，若后续操作依赖指针位置（比如Streamlit内部处理），可能导致读取到空数据。

解决方向：在prs.save(binary_summary)后添加binary_summary.seek(0)，将指针重置到流的起始位置。

3. Azure WebApp资源限制或临时存储问题 #

• 若生成的PPT文件过大，可能超出Azure WebApp的内存限制，导致二进制数据未完整生成
• Azure WebApp的临时存储有大小限制，若R脚本生成的中间文件占用过多空间，可能影响后续操作

解决方向：

• 检查Azure门户中WebApp的「监控」面板，查看CPU、内存使用率是否超标
• 清理R脚本生成的临时文件，避免占用过多存储

4. 依赖库版本变更 #

Azure WebApp可能自动更新了Streamlit、python-pptx或其他依赖库的版本，导致API兼容性问题：

• Streamlit的download_button参数要求变更
• PPT生成库的save()方法对BytesIO的处理逻辑变化

解决方向：

• 在requirements.txt中固定依赖库的版本号，避免自动更新
• 本地环境复现Azure的依赖版本，测试下载功能是否正常

5. 网络或Azure应用服务配置问题 #

• Azure WebApp的出站网络限制，导致生成PPT时的数据库查询或文件处理超时，未生成有效二进制数据
• WebApp的HTTPS配置或反向代理设置异常，导致下载请求被拦截

解决方向：

• 检查Azure WebApp的「网络」配置，确保数据库连接和外部资源访问正常
• 查看WebApp的「日志流」，获取具体的错误堆栈信息，定位问题

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