路边两盏灯_社区达人页

2026年05月

• 05.15 18:39:30
  发表了文章 2026-05-15 18:39:30

  【Azure Developer】ASP.NET Framework 4.8 集成 Azure Application Insights SDK 完整指南

  本文详解如何在老旧的.NET Framework 4.8项目中集成Azure Application Insights SDK（推荐2.23.0版），实现请求追踪、异常捕获与性能监控。涵盖SDK选型、NuGet安装、Connection String配置、web.config模块注册、自定义遥测及数据验证，并提醒Auto-Instrumentation冲突等常见问题。
• 05.12 19:08:05
  发表了文章 2026-05-12 19:08:05

  【Azure Container App】容器应用的维护窗口设置

  Azure Container Apps 平台会自动执行维护更新，分关键（即时）与非关键（可预约）两类。可通过 CLI 为环境配置计划维护窗口（8–24 小时），将非关键更新约束在业务低峰期，降低影响。该功能仅适用于工作负载配置档环境。
• 05.11 19:49:55
  发表了文章 2026-05-11 19:49:55

  【Azure 应用服务】WEBSITE_DISABLE_CROSS_STAMP_SCALE 配置的作用说明

  `WEBSITE_DISABLE_CROSS_STAMP_SCALE` 是 Azure App Service/Function App 的平台级配置，用于禁用同一区域内跨 Stamp（扩展单元）的实例调度，以减少因位置差异导致的 DNS、网络或连接问题。它并非 DNS 或超时修复开关，而是排查网络不稳定的“隔离变量”工具，需配合 VNet、DNS、防火墙等配置综合诊断。（239字）
• 05.06 20:19:52
  发表了文章 2026-05-06 20:19:52

  【Azure App Service】在App Service中使用az cli命令创建 Sidecar Container

  本文详解 Azure App Service 中 Sidecar 容器的 CLI 实现方案。针对门户无“Container”选项的问题，提供 `az webapp sitecontainers create/update` 命令的完整六步操作流程（含环境配置、主/边车容器部署），并支持状态验证与最佳实践说明，替代繁琐 ARM 模板。
• 05.03 16:21:34
  发表了文章 2026-05-03 16:21:34

  【Azure App Service】为什么 Web App 上的文件会被"锁死"？

  Azure App Service中，/home目录文件可能出现“僵尸锁”：stat显示Links:0，文件已删但句柄未释放，导致无法删除/移动、FTP/Kudu失效、重启无效。根因是Azure Files远程存储的SMB会话未断开。推荐绕过方案：复制文件+更新引用+重启应用。

2026年04月

• 04.30 20:43:23
  发表了文章 2026-04-30 20:43:23

  【Azure Container App】使用 yaml 部署 Container App 时遇见 400 Bad Request 错误

  使用 `az containerapp create --yaml` 时，CLI 扩展会将未定义字段序列化为 `null`，导致 ARM 反序列化失败（如 `allowInsecure: null` 被误转为布尔值），引发 400 错误。解决方案：在 YAML 中显式设置 `allowInsecure: false` 等必填/非空字段。
• 04.29 20:37:30
  发表了文章 2026-04-29 20:37:30

  【App Service】查看Application Insights自身SDK日志的方法示例

  本文介绍当App Service启用Application Insights后仍无遥测数据时，可启用其自诊断功能：通过Kudu添加`ApplicationInsightsDiagnostics.json`配置文件，设置日志路径、大小与级别（Verbose），重启应用后按新PID查看详细日志，快速定位SDK初始化或传输失败原因。（239字）
• 04.22 21:42:48
  发表了文章 2026-04-22 21:42:48

  【App Service】排查App Service中发送Application Insights日志数据问题的神级脚本: Test-AppInsightsTelemetryFlow.ps1

  本文介绍 Azure 中国区 Application Insights 日志无数据问题的排查利器——微软官方诊断脚本 `Test-AppInsightsTelemetryFlow.ps1`。该脚本可逐层验证 SDK、网络、TLS、ingestion endpoint 等遥测链路，精准定位日志丢失环节，支持 PowerShell（Windows）和 Bash（Linux），大幅提升故障排查效率。（239字）
• 04.21 20:28:20
  发表了文章 2026-04-21 20:28:20

  【App Service】常规排查 App Service 启动 Application Insights 无数据的步骤 (.NET版本)

  本文详解Application Insights在Azure App Service中无日志数据的三大原因及排查方法：1）网络连通性（验证到AI端点的443端口访问）；2）w3wp.exe进程是否成功加载AI模块；3）DLL冲突（检查并移除重复的Microsoft.ApplicationInsights等组件）。
• 04.14 20:09:32
  发表了文章 2026-04-14 20:09:32

  【Azure Developer】IIS w3wp.exe 的 -m 参数：一个未被记录的管道模式标识

  本文揭秘了IIS中未公开的`w3wp.exe -m`启动参数：`-m 0`表示Integrated管道模式（推荐），`-m 1`为Classic模式。该发现源于Application Insights自动检测失效的排查，解释了其为何不支持Classic模式——因HttpModule无法全面拦截请求。
• 04.13 21:22:40
  发表了文章 2026-04-13 21:22:40

  【Azure App Service】PHP页面上传文件413错误的解决方案

  在使用 Azure App Service（Linux + PHP） 部署 Web 应用时，如果上传文件大于1MB，就会遇到 HTTP 413（Request Entity Too Large） 错误。 # 问题解答 ### 一、HTTP 413 错误的本质含义 413 Request Entity Too Large 是标准 HTTP 状态码，表示： > 客户端提交的请求体（Request Body）大小超过了服务器当前允许的最大限制。 在 Azure App Service（Linux）环境中，这个错误并不一定来自前端网关(Frontend)，而更常见的来源是 App...
• 04.10 22:44:26
  发表了文章 2026-04-10 22:44:26

  【Azure Redis】云原生环境下的 Redis 超时之谜：为什么 15 分钟后应用才恢复？

  云原生中Redis短暂不可用后应用持续超时15分钟？问题不在Redis，而在Linux TCP默认重传机制（tcp_retries2=15）与长连接模型的错位。需三管齐下：调低内核重传次数、客户端显式配置超时与自动重连、应用层引入断路器与弹性重试。
• 04.07 22:45:17
  发表了文章 2026-04-07 22:45:17

  【Azure Developer】.NET Aspire 启动报错：listen tcp bind: An attempt was made to access a socket in a way forbidden by its access permissions

  .NET Aspire在Windows启动时因Hyper-V端口保留机制，导致DCP代理无法绑定53209等端口（报错“访问被拒绝”）。虽端口未被占用，但已被系统保留。推荐方案：修改launchSettings.json，将服务端口改为7xxx等安全范围；或临时重启winnat服务、永久排除指定端口。

2026年03月

• 03.30 21:12:15
  发表了文章 2026-03-30 21:12:15

  【Azure APIM】API导入功能报错 Unable to parse specified file.

  Azure APIM导入OpenAPI文件报“Unable to parse specified file”错误，表面是格式问题，实则因导出文件含非法Unicode字符（如с），导致UTF-8编码被误读。通过Swagger Editor定位并修正后可正常导入。
• 03.25 20:46:10
  发表了文章 2026-03-25 20:46:10

  【Azure App Service】为什么 Azure Web App 禁用公网后 Advanced Tools 会失效？

  Azure Web App运行正常但Advanced Tools（Kudu）无法访问？根源在于网络访问限制：Kudu作为独立SCM站点，默认沿用主站规则。若主站禁用公网访问而未单独放行Kudu端点，请求将在网络层被阻断。只需为Advanced Tools站点配置独立访问规则即可解决。

  
• 03.24 20:34:43
  发表了文章 2026-03-24 20:34:43

  【Azure AI Search】AI Search的索引器(Indexer)中使用解码函数base64Decode报错

  Azure AI Search索引器使用base64Decode时失败，因默认启用URL安全解码（useHttpServerUtilityUrlTokenDecode=true），而源数据为标准Base64编码。解决方案：在mappingFunction中显式设置`"useHttpServerUtilityUrlTokenDecode": false`，即可正确解码。
• 03.16 21:29:29
  发表了文章 2026-03-16 21:29:29

  【Azure Key Vault】下载Key Vault中保存证书的PFX文件报错问题分析

  Azure Key Vault中下载PFX证书失败（报403 Forbidden），根源在于PFX含私钥，以Secret形式存储，需显式授予`secrets/get`权限——仅Certificate权限只能访问公钥，无法获取私钥内容。
• 03.12 20:05:29
  发表了文章 2026-03-12 20:05:29

  【Azure Container App】Debug Console的调试工具试验（三）--openssl/traceroute/ca-certificates/bind-utils/tcpping

  本文是Azure Container App Debug Console调试工具系列第三篇，详解openssl、traceroute、ca-certificates、bind-utils和tcpping五种核心工具的实战用法：涵盖SSL证书诊断、网络路径追踪、CA证书管理、DNS解析排查及TCP端口连通性测试，助力高效定位云环境网络与安全问题。
• 03.11 20:06:22
  发表了文章 2026-03-11 20:06:22

  【Azure Container App】Debug Console的调试工具试验（二）-- lsof/ util-linux / netcat / wget

  本文续讲Azure Container App Debug Console调试工具试验，详解lsof（端口/文件句柄排查）、util-linux（dmesg/mount/df等系统诊断）、netcat（网络连通性测试）及wget（HTTP端点验证）四大工具的实战用法与典型场景，助力高效排障。
• 03.05 20:11:01
  发表了文章 2026-03-05 20:11:01

  【Azure Container App】Debug Console的调试工具试验（一）-- iputils / net-tools / procps

  在使用 Azure Container Apps 时，很多问题只在生产环境出现： 应用无法访问外部服务、端口监听异常、CPU 飙高却找不到原因。 当你进入 Debug Console 后，真正能用的工具到底有哪些？ 这些工具又该在什么场景下使用？ 本系列文章将对 Debug Console 中预装的调试工具进行逐一实测， 帮你在没有 SSH、没有 VM、没有 kubectl 的情况下完成有效排障。
• 03.02 20:11:24
  发表了文章 2026-03-02 20:11:24

  【Azure Container App】Debug Console的调式工具指南

  在云原生时代，Azure Container Apps 调试控制台预装12类诊断工具（如ip-utils、netcat、openssl、dig等），覆盖网络、进程、SSL、DNS等全链路排查场景，助开发者快速定位容器故障。

2026年02月

• 02.28 20:40:45
  发表了文章 2026-02-28 20:40:45

  【Azure App Service】记录App Service Kudu站点的File Manger中无法查看文件列表的原因

  本文描述Azure App Service Kudu控制台中文件目录UI显示为空（实际有文件），但PowerShell的`ls`命令可正常列出的问题。通过浏览器开发者工具定位到Unicode字符编码错误（\uDC6D），根源是文件名含非法代理对字符。解决方案：检查并重命名本地文件。
• 02.27 21:24:27
  发表了文章 2026-02-27 21:24:27

  【Azure Redis】在Azure Cache for Redis上试验monitor指令效果

  本文介绍如何在Azure Cache for Redis中实时监控执行命令：通过`MONITOR`命令可实时捕获所有客户端请求日志，含时间戳、数据库号、客户端IP及完整命令。但因其加重主线程负担，**不建议生产环境使用**。
• 02.14 17:16:33
  发表了文章 2026-02-14 17:16:33

  【Azure App Service】为什么启用 Health Check 后应用服务实例持续显示 Unhealthy？

  App Service健康检查因HTTP→HTTPS自动跳转导致实例被标记为Unhealthy。默认Health Check走HTTP（端口80），若应用启用强制HTTPS重定向（如.NET Core的UseHttpsRedirection），则响应301而非2xx，触发误判。解决方案：启用“HTTPS Only”使Health Check改用HTTPS（443端口）探测。
• 02.13 19:18:21
  发表了文章 2026-02-13 19:18:21

  【Azure App Service】32位 Windows App Service 最大能使用多少内存？

  本文详解Windows Azure Web App（32位）内存限制问题：阐明32位进程理论上限4GB、默认用户态仅2GB；对比In-Process（共享w3wp.exe，约2GB）与Out-of-Process（独立dotnet.exe，近4GB）模式的内存差异；解析Sandbox限制（物理内存×75%）、多虚拟目录影响及SCM进程计入规则，并提供Portal、Kudu、App Insights三大监控方案。（239字）
• 02.13 19:08:06
  发表了文章 2026-02-13 19:08:06

  【Azure APIM】为何APIM自建网关中的cache-lookup-value策略无法正常工作？

  APIM自建网关（Self-hosted Gateway）使用`cache-lookup-value`策略时，若配置external Redis缓存却无法命中，常见原因为网关与外部缓存的location/region不一致，日志报错`CacheEventIgnoredDueToRegionMismatch`。解决方法：确保网关YAML中`location`字段与Redis所在region严格匹配；若Redis设为`default`则无限制。需在APIM门户核对并统一配置。
• 02.11 21:23:30
  发表了文章 2026-02-11 21:23:30

  【Azure Event Hub】在VMSS中使用WAD(Window Azure Diagnostic)插件发送日志到Event Hub中报错分析

  本文分析Azure VMSS中WAD扩展向Event Hub推送日志时出现丢失的问题。错误提示“Event Hub is too busy”及“50+ batches in queue”表明非服务端瓶颈，而是WAD客户端本地队列满（硬编码上限50批），因日志生成速度超过发送速度所致。建议扩容VMSS实例或优化WAD sinks配置分流日志。
• 02.10 22:32:31
  发表了文章 2026-02-10 22:32:31

  【Azure Function】在Azure上的 Python Function 资源被扫描出包含安全漏洞

  Azure Python Function因`cryptography<41.0.5`（当前3.1.1）存在CVE-2023-5363高危漏洞。本地开发可直接修改requirements.txt；Portal创建的函数则需通过Kudu站点（scm.chinacloudsites.cn）进入/wwwroot，编辑requirements.txt升级版本并重启应用。
• 02.06 19:22:00
  发表了文章 2026-02-06 19:22:00

  【Azure Function App】部署完 Azure Function 发现 Function 在门户消失了

  VS Code部署Python Function App至Azure成功，但门户无函数显示。经查，因`WEBSITE_RUN_FROM_PACKAGE=1`导致依赖未按requirements.txt安装，缺失`azure.monitor`包。解决：设该变量为0，补全依赖，重新部署即可。
• 02.04 19:41:17
  发表了文章 2026-02-04 19:41:17

  【Azure 环境】获取Azure上资源的创建时间createdTime信息(ARM REST API版本)

  Azure Redis GET API不返回systemData.createdTime。可通过ARM Resources List API（$expand=createdTime）获取创建时间，但迁移后显示迁移完成时间而非原始创建时间。

2026年01月

• 01.30 20:55:29
  发表了文章 2026-01-30 20:55:29

  【Azure Storage Account】Azure Table Storage 跨区批量迁移方案

  本文介绍Azure Table Storage跨区域批量迁移方案：因无原生复制能力，需通过AzCopy分两步实现——先导出表数据至Blob（生成manifest），再从Blob导入目标区域Table，支持脚本化、可重试、自动覆盖冲突，大幅提升效率与可靠性。（239字）
• 01.25 15:39:03
  发表了文章 2026-01-25 15:39:03

  【Azure APIM】APIM的自建网关如何解决自签名证书的受信任问题呢？(不成功方案的分析)

  本文探讨Azure APIM自建网关信任自签名证书的第四种方案——通过`az aks update --custom-ca-trust-certificates`将CA证书注入AKS节点。经验证，该方法仅作用于节点系统层，对Pod内运行的APIM网关容器无效（因其使用.NET TLS路径，不读取系统CA）。最终确认：解决信任问题仍需回归前三种Pod级方案（如环境变量SSL_CERT_FILE、镜像预装或跳过验证）。
• 01.23 19:28:06
  发表了文章 2026-01-23 19:28:06

  【Azure APIM】APIM的自建网关如何解决自签名证书的受信任问题呢？(方案三)

  本文详解在Azure AKS中为APIM自建网关Pod信任自签名证书的实践方案：通过创建CA证书Secret、挂载至容器，并设置SSL_CERT_FILE环境变量，使网关成功验证后端HTTPS服务。附完整YAML配置与排错日志分析。（239字）
• 01.21 21:27:53
  发表了文章 2026-01-21 21:27:53

  【Azure APIM】APIM的自建网关如何解决自签名证书的受信任问题呢？(方案二)

  本文介绍如何在Azure APIM中配置忽略自签名证书的验证，通过禁用证书链校验（SkipCertificateChainValidation），实现APIM与后端HTTPS服务的安全通信，适用于托管网关与自建网关场景，提升部署灵活性，但需注意潜在安全风险。
• 01.19 21:23:10
  发表了文章 2026-01-19 21:23:10

  【Azure APIM】APIM的自建网关如何解决自签名证书的受信任问题呢？(方案一)

  本文详解在Azure APIM自建网关部署于AKS时，如何解决HTTPS自签名证书不被信任的问题。通过上传根/中间证书、调用REST API标记为可信，实现POD内证书信任，确保后端服务安全通信。
• 01.17 12:30:27
  发表了文章 2026-01-17 12:30:27

  【Azure APIM】如何解决后端API服务配置自签名证书时APIM请求报错500：Error occured while calling backend service

  本文介绍在Azure API管理（APIM）中使用自签名证书时，因CA证书不受信任导致后端HTTPS连接失败的问题及解决方案。通过分析错误日志和验证流程，指出需将根CA和中间CA证书分别上传至APIM的受信任证书库，并强调仅上传完整链PFX文件无效。最终按正确步骤上传CER格式的CA证书后，问题得以解决，实现安全通信。
• 01.13 21:21:21
  发表了文章 2026-01-13 21:21:21

  【Azure 环境】在Windows环境中使用OpenSSL生成自签名证书链步骤分享

  本文详解如何使用OpenSSL生成自签名证书链，包括根CA、中间CA和服务器证书，并最终打包为包含私钥的PFX文件，适用于内部系统或测试环境部署，步骤清晰，可复制即用。
• 01.10 12:31:48
  发表了文章 2026-01-10 12:31:48

  【Azure Redis】客户端应用使用 Azure Redis Cluster 报错 java.security.cert.CertificateException: No subject alternative names matching IP address xxx.xxx.xxx.xxx found

  使用Lettuce连接Azure Redis集群时，因SSL证书仅含域名不支持IP地址，导致“CertificateException”错误。通过自定义`MappingSocketAddressResolver`，将IP映射为域名进行证书验证，结合`ClientResources`配置实现安全连接，最终成功访问Redis集群并执行操作。
• 01.07 20:52:43
  发表了文章 2026-01-07 20:52:43

  【Azure App Service】App Service 遇见 not enough space on the disk

  App Service应用提示“磁盘空间不足”时，可通过PowerShell脚本快速统计c:\home和c:\local目录下各文件夹大小，定位大文件并删除，释放空间。
• 01.04 20:13:50
  发表了文章 2026-01-04 20:13:50

  【Azure Web App】Github Action部署Jar包到App Service报400错误

  通过GitHub Action部署Azure App Service时遇400错误，根源在于Jar包无法部署至Stack为Tomcat的应用。需将App Service运行栈改为Java SE，并可通过az CLI或curl复现验证。最终确认Kudu源码中对部署类型有严格校验。

2025年12月

• 12.30 21:34:44
  发表了文章 2025-12-30 21:34:44

  【Azure Bot Service】在机器人服务中如何调用LLM来回答问题呢？

  本文介绍如何在Azure Bot Service中嵌入大模型，实现智能对话。通过调用Azure OpenAI的API，在Bot的on_message_activity方法中接入大模型响应，使机器人具备更强大的自然语言处理能力，提升交互体验。
• 12.26 20:24:11
  发表了文章 2025-12-26 20:24:11

  【Azure Entra ID】AcquireTokenForClient 触发 Entra ID 请求风暴？Shared Cache 才是 Web App 登录的正确方式

  Web App调用Azure Entra ID中国区时因未有效缓存令牌，导致请求激增、登录不稳定。根本原因在于MSAL的`ConfidentialClientApplication`未复用且未启用共享缓存。通过单例模式创建应用实例，并配置`WithCacheOptions(CacheOptions.EnableSharedCacheOptions)`，可使令牌在有效期内被复用，避免频繁请求认证端点，显著降低Entra ID负载，提升系统稳定性和性能。
• 12.24 22:12:25
  发表了文章 2025-12-24 22:12:25

  【Azure Notification Hub】实验Notification Hub页面中的Test Tag 功能 -- 定向发送消息到指定的Android设备

  本文介绍如何通过为设备注册时添加Tag，并在Azure通知中心的测试功能中指定Tag表达式，实现向特定设备或设备类精准发送测试通知，解决默认仅支持随机发送10台设备的限制，提升调试效率。
• 12.15 17:43:33
  发表了文章 2025-12-15 17:43:33

  【Azure Stream Analytic】用 JavaScript UDF 解决 JSON 字段被转成 Record 的关键点

  Azure Stream Analytics将JSON对象输出为CSV时，会自动将其序列化为Record类型，导致数据无法正常解析。根本原因是ASA将JSON对象识别为结构化类型而非字符串。解决方法：通过JavaScript UDF（如`JSON.stringify`）将对象显式转为字符串，再输出至CSV，确保下游系统正确读取。
• 12.12 21:22:22
  发表了文章 2025-12-12 21:22:22

  【Azure Developer】中国区Azure环境中查看用户账号是否可用(accountEnabled)的操作步骤

  本文介绍在21V（世纪互联运营的中国版Azure）环境中，如何通过Microsoft Graph API正确获取用户accountEnabled状态。针对国家云与全球版在令牌端点、域名及权限范围上的差异，提供从登录、获取Token到查询用户状态的完整操作步骤，避免401/403错误或属性返回null的问题，确保API调用成功。
• 12.09 20:48:28
  发表了文章 2025-12-09 20:48:28

  【Azure APIM】如何实现对经过APIM并到达后端服务请求的全链路追踪呢？

  在Azure API Management中，为实现全链路请求跟踪，可通过RequestId生成唯一标识x-request-id，并在inbound、outbound和on-error策略中注入该Header，结合诊断日志记录，实现跨网关与后端服务的统一追踪，提升问题排查效率。
• 12.07 14:59:11
  发表了文章 2025-12-07 14:59:11

  【Azure App Service】部署在应用服务上的WebJob中，为何会多出一个名为"DaaS"的 WebJob呢？

  Azure App Service 中的“DaaS”WebJob是平台内置诊断工具（Diagnostics as a Service），用于性能分析、故障排查和自动化诊断。它仅在触发诊断时运行，平时不占用资源，删除后会自动重建，保留安全且不影响应用性能。
• 12.04 23:06:59
  发表了文章 2025-12-04 23:06:59

  【Azure Policy】实现拒绝新建/可以修改已存在资源的 Azure Policy 方案

  本文介绍如何在Azure中通过结合Audit策略、豁免（Exemption）和Deny策略，实现“禁止新建资源但允许修改已有资源”的管控需求，解决Azure Policy无法直接区分创建与修改操作的限制，提供一种实用的变通方案。