Azure App Service中WordPress存储账户功能异常排查求助

核心配置验证 #

• 确认BLOB_STORAGE_ENABLED的值是严格小写的true，Azure应用设置对大小写敏感，自动创建的配置若为True或TRUE都会导致功能失效
• 验证存储账户密钥权限：用当前配置的存储账户密钥，在Azure存储资源管理器中尝试手动上传文件到目标容器，确认密钥拥有Blob读写权限
• 检查容器访问级别：确保目标容器的公共访问级别设置为私有（仅限Blob访问）或更高，避免权限拦截

应用内部机制排查 #

• 检查wp-config.php配置：通过SCM站点查看该文件，确认是否自动注入了Blob存储相关代码，正常应包含类似define('WP_AZURE_BLOB_STORAGE_ENABLED', getenv('BLOB_STORAGE_ENABLED'));的定义，以及对应存储类的加载逻辑。若缺失，需手动添加文档指定的代码片段
• 查看应用日志：在SCM站点的Log Files > Application > logs目录下，检查PHP错误日志或WordPress调试日志，排查是否有存储连接失败的具体报错（如密钥无效、容器不存在等）
• 验证挂载状态：在SCM站点的Console中执行df -h命令，查看是否有Azure Blob存储挂载到WordPress的wp-content/uploads目录，无挂载记录则说明挂载过程失败

额外配置检查 #

• 确认运行栈版本：确保App Service使用的PHP版本在Blob存储功能支持范围内（建议PHP 7.4及以上）
• 排查插件冲突：临时禁用所有第三方WordPress插件后测试上传，排查是否有缓存、媒体管理类插件覆盖了默认上传路径

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