路边两盏灯_社区达人页

2026年04月

• 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无法直接区分创建与修改操作的限制，提供一种实用的变通方案。
• 12.03 21:04:02
  发表了文章 2025-12-03 21:04:02

  【Azure AI Search】如何通过Entra ID RBAC认证连接中国区 Azure AI Search

  本文介绍如何在Java SDK中配置中国区AI Search资源访问。由于默认认证地址为全球环境（https://search.azure.com），在中国区需修改为https://search.azure.cn，并通过设置SearchAudience.AZURE_CHINA解决认证失败问题，确保资源正常获取。
• 12.01 21:26:51
  发表了文章 2025-12-01 21:26:51

  【Azure Policy】借助 Azure Resource Graph 查询策略分配、符合性状态以及策略定义

  本文介绍如何通过Azure Resource Graph使用KQL查询，批量导出Azure Policy的策略分配、不合规资源统计及策略定义详情，弥补门户无直接导出功能的不足，助力合规分析与治理优化。

2025年11月

• 11.26 10:54:45
  发表了文章 2025-11-26 10:54:45

  【Azure Function App】Function App出现500异常 Microsoft.Azure.WebJobs.Script.Workers.WorkerProcessExitException : C:\Program Files\dotnet\dotnet.exe exited with code -532462766 (0xE0434352)

  Azure Function App 出现500错误，因EF Core未正确配置自增字段导致进程崩溃。异常提示实体属性有临时值，无法改为“Unchanged”。解决方案：通过`ValueGeneratedOnAdd()`或`[DatabaseGenerated]`特性显式声明ID自增，避免状态跟踪异常，确保高并发下稳定运行。
• 11.25 09:41:33
  发表了文章 2025-11-25 09:41:33

  【Azure Application Insights】如果关闭 Profiler 和 Snapshot Debugger 功能，是否会影响日志收集或查询

  关闭Azure Application Insights的Profiler和Snapshot Debugger不会影响日志收集与查询。日志功能独立于二者，仍可正常采集请求、异常等数据。Profiler用于性能分析，Snapshot Debugger捕获异常时的代码快照，两者按需启用即可，避免额外资源消耗，不影响核心监控。
• 11.20 20:44:58
  发表了文章 2025-11-20 20:44:58

  【App Service】.NET 应用在App Service上内存无法占用100%的问题原因

  在Azure App Service（Windows）部署.NET应用时，即使内存未满100%，也可能出现OOM错误。原因是.NET运行时对GC堆内存设有硬限制，默认仅使用75%的可用内存。可通过配置`runtimeconfig.json`中的`System.GC.HeapHardLimitPercent`或`HeapHardLimit`参数调整该限制，提升内存利用率。
• 11.18 20:44:23
  发表了文章 2025-11-18 20:44:23

  【Azure Developer】解决在中国区 Microsoft Graph 命令Get-MgUserAuthenticationPhoneMethod 不可用的问题

  使用PowerShell的Microsoft Graph命令在Azure中国区获取用户认证电话信息时，`Get-MgUserAuthenticationPhoneMethod`报错“资源未找到”。原因是该命令在中国区正式版中暂不支持，需改用Beta版本。解决方案：卸载`Microsoft.Graph`，安装`Microsoft.Graph.Beta`，登录中国区环境后使用`Get-MgBetaUserAuthenticationPhoneMethod`即可成功获取数据。
• 11.11 20:04:07
  发表了文章 2025-11-11 20:04:07

  【Azure Developer】azd 安装最新版无法登录中国区问题二：本地Windows环境遇问题

  本文记录了在Windows本地环境使用Azure Developer CLI（azd）登录中国区Azure时的认证错误及解决方案。最新版本azd存在对中国区endpoint支持问题，导致登录失败。通过卸载最新版并手动安装1.19.0旧版本msi包，可成功解决该问题，实现正常登录。
• 11.10 20:26:06
  发表了文章 2025-11-10 20:26:06

  【App Service】应用在Entra ID认证完成后，回跳页面遇401错误 "Cookie is missing after a redirect from IDP, authentication has failed"

  Azure App Service应用在登录回调时出现401错误，提示“Cookie is missing after redirect”。经排查，因Entra ID配置中Cookie的Domain属性包含HTTPS协议，导致浏览器拒绝设置Cookie。修正Domain值后问题解决。
• 11.03 17:09:17
  发表了文章 2025-11-03 17:09:17

  【App Service】Java应用上传文件功能部署在App Service Windows上报错 413 Payload Too Large

  Java应用在Azure App Service（Windows）部署时，因IIS默认限制上传文件不超过30MB，导致大文件上传出现413错误。虽无web.config文件，可通过Kudu工具手动创建并配置maxAllowedContentLength和maxRequestLength，突破限制，实现大文件上传。

2025年10月

• 10.26 16:19:36
  发表了文章 2025-10-26 16:19:36

  【App Service】部署War包到Azure云上遇404错误

  Java应用部署至Azure App Service for Windows后报404，本地运行正常。经排查，日志提示类文件版本不兼容：应用由Java 17（class file version 61.0）编译，但环境仅支持到Java 11（55.0）。错误根源为Java版本不匹配。调整App Service的Java版本至17后问题解决，成功访问接口。
• 10.25 10:29:32
  发表了文章 2025-10-25 10:29:32

  【Azure Entra ID】当Entra ID中的用户所属Group数量超过200个之后的问题

  Azure Entra ID中，当用户所属组超过200个时，ID Token仅返回endpoint。通过配置组筛选（Group Filtering），可按应用需求过滤并直接返回指定组列表，避免获取全部组，提升效率。
• 10.22 21:15:30
  发表了文章 2025-10-22 21:15:30

  【Azure Storage Account】Java Code访问Storage Account File Share的上传和下载代码示例

  本文介绍如何使用Java通过azure-storage-file-share SDK实现Azure文件共享的上传下载。包含依赖引入、客户端创建及完整示例代码，助你快速集成Azure File Share功能。