按Wiki JS官方文档部署Azure Web App后出现应用错误求助

• 检查Postgres防火墙规则
  确认Azure Postgres服务器的防火墙允许Web App访问：

  • 进入Postgres服务器的「连接安全」页面，添加Web App的所有出站IP（可在Web App的「网络」→「出站IP地址」中获取）
  • 确保「允许Azure服务和资源访问此服务器」选项已开启

• 验证数据库连接配置
  核对Web App应用设置中的数据库参数，确保和Azure Postgres的信息匹配：

  • DB_TYPE必须设为postgres
  • DB_HOST是Postgres服务器的完整FQDN（例如xxx.postgres.database.azure.com）
  • DB_PORT保持默认5432（除非你修改过Postgres端口）
  • DB_NAME是你创建的目标数据库名称，不是服务器名称
  • DB_USER格式为用户名@服务器名（Azure Postgres强制要求的格式）
  • DB_PASS是正确的数据库密码，注意特殊字符无需额外转义

• 查看Web App容器日志
  开启日志流获取具体错误信息：

  • 在Azure Portal进入Web App的「日志流」页面，实时查看Docker容器的输出日志
  • 或通过「高级工具(Kudu)」→「调试控制台」→「日志目录」，查看/home/LogFiles/下的容器日志，里面会明确显示连接失败的原因（如认证错误、超时、数据库不存在等）

• 排查App Service计划变更影响
  由于昨日基础计划可正常运行，今日出错需确认计划变更的影响：

  • 若更换了计划（如切换到免费层），检查新计划是否有网络限制（例如免费层无法访问VNet内的Postgres）
  • 临时切回基础计划测试，确认是否是计划本身的限制导致问题

• 确认Docker镜像版本
  检查Web App使用的WikiJS镜像版本：

  • 避免使用latest镜像，尝试指定文档推荐的稳定版本（如requarks/wiki:2），防止镜像更新带来的兼容性问题

• 检查数据库用户权限
  确保连接Postgres的用户拥有足够权限：
  在Postgres查询编辑器中执行命令：

  GRANT ALL PRIVILEGES ON DATABASE 你的数据库名 TO 用户名;
  

  执行后重启Web App重试

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