Swashbuckle.Core 5.6.0+Web API2自托管Swagger注释缺失排查求助
我之前在Web API 2项目里用Swashbuckle时也碰到过类似的注释丢失问题，结合你的场景，给你整理几个实用的排查方向：
先确认XML文件本身的内容是否正确
直接打开那两个XML文件，搜索你的控制器类名或者方法名，看看有没有对应的<member>节点。比如找类似<member name="T:YourNamespace.YourController">（对应控制器类）或者<member name="M:YourNamespace.YourController.Get(int)">（对应方法）的条目。如果没有，说明项目生成XML时没包含这些注释，得回去检查每个类库的生成配置：- 右键类库项目 → 属性 → 生成 → 勾选“XML文档文件”，确保路径和你代码里引用的一致
- 注意不要勾选“将警告视为错误”（如果有未注释的公共成员，会导致编译失败，XML文件可能不完整）
验证XML文件的路径匹配度
虽然你说调试时路径解析正常，但还是要确认文件名的大小写、后缀是否完全匹配（比如是不是写成了.xml而不是.XML？Windows下不敏感，但某些自托管环境可能会有问题）。另外可以尝试只加载其中一个XML文件，测试注释是否能显示，以此排除某一个文件损坏或格式错误的情况。检查命名空间和XML节点的一致性
XML文件里的<member>节点的name属性是严格匹配代码的命名空间的。比如XML里写的是M:Company.Product.Controllers.UserController.GetUserById，而你的控制器实际命名空间是Company.Product.Api.Controllers，那Swashbuckle就找不到对应关系，注释自然不会显示。一定要确保XML里的命名空间和代码完全一致。确认XML文件的编码和格式
有些时候XML文件的编码（比如带BOM的UTF-8）或者格式错误会导致Swashbuckle解析失败。可以用记事本打开XML文件，选择“另存为”，确认编码是UTF-8（无BOM），同时检查XML是否有语法错误（比如标签未闭合）。排查权限和文件读取问题
虽然调试时权限通常没问题，但还是可以在代码里加一行测试：用File.ReadAllText(AppDomain.CurrentDomain.BaseDirectory + "commentsfile1.xml")读取XML内容，看看是否能正常获取。如果读取失败，说明进程没有该文件的读取权限，需要调整文件所在目录的权限。测试单个XML文件的加载效果
暂时注释掉其中一个IncludeXmlComments调用，只加载一个XML文件，看注释是否能显示。如果其中一个能显示，另一个不行，说明那个有问题的XML文件可能生成不完整或者内容有误。检查Swashbuckle版本的兼容性
Swashbuckle.Core 5.6.0是比较老的版本，虽然支持Web API 2，但有没有可能存在多个XML文件加载的bug？可以尝试把两个XML文件手动合并成一个（复制粘贴<members>节点里的内容，注意不要重复根节点），然后加载合并后的文件，看注释是否正常显示。
内容的提问来源于stack exchange，提问作者Stephan Steiner
