QGIS Server出现LayerNotDefined错误：图层存在却无法识别

可能原因及对应解决办法： #

• 图层WMS名称不匹配
  QGIS Server识别的是图层属性里的内部名称（Name），而非图层的显示名称。右键图层mexpro → 属性 → 元数据 → 基本信息，确认「名称」字段值与请求URL中LAYERS=mexpro完全一致。若不一致，修改URL中的LAYERS参数值或图层的内部名称。

• 项目路径格式错误
  Windows系统下，URL中的本地路径需将反斜杠\替换为正斜杠/，或用双反斜杠\\转义。原请求中的路径C:\EXPROP\PROYECTOS\testuniones\testuniones.qgs需改为：

  MAP=C:/EXPROP/PROYECTOS/testuniones/testuniones.qgs
  

  同时确认该.qgs文件真实存在，且QGIS Server服务进程对该路径有读取权限。

• URL存在无效重复参数
  请求URL中重复了BBOX=-90,-180,90,180参数，属于无效配置，删除其中一个，保留单个BBOX参数即可。

• 图层未在WMS服务中发布
  打开QGIS项目，进入项目 → 项目属性 → OWS服务器：

  • 勾选「发布此项目为WMS服务」
  • 在「WMS能力」列表中确认mexpro图层已被勾选
  • 确保服务配置无特殊字符，避免解析异常

• 验证服务能力文档
  先请求WMS的GetCapabilities接口，确认图层是否已被正确发布：

  localhost:8080/qgis-ltr/qgis_mapserv.fcgi.exe?MAP=C:/EXPROP/PROYECTOS/testuniones/testuniones.qgs&SERVICE=WMS&VERSION=1.3.0&REQUEST=GetCapabilities
  

  在返回的XML内容中搜索mexpro，若无法找到，说明图层未被正确配置发布，需回到项目中重新检查。

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