使用Asp.net core webAPI + Swagger搭建web服务的步骤以及问题点

在下从毕业到现在一直都是用微软的技术栈去开发东西。

asp.net core发布也有一段时间了，一直没有去系统的关注一下，最近得闲准备用core的webapi做点东西，也遇上了一些小问题，就把这些东西都记录下来。

1.创建工程：
这就没什么可说了，创建工程这个用VS再简单不过了，我选的是Api的选项。
core创建web工程会把entityframework直接放到依赖项当中，这个也不必细说。

2.配置swaggerui
启动工程之后，还是bootstrap的界面，api方法描述也只是描述不能交互，这点还是挺不方便的。
好在swagger也是可以应用在.net上的。

如何配置swagger
https://docs.microsoft.com/en...
微软的这篇文章记述的也是很明白了，大家按图索骥即可。

有个细节需要注意一下
就是当大家配置好之后

有可能会出现这种500的错误，就是加载api描述json失败，遇到这种情况，第一反应是要到

console里面去找信息，反正我遇到的情况就是controller当中方法共用了一个api地址
导致识别api错误。

在这提个醒，下面是正常的图像。

3.关于EntityFramework
到这一步基本上事儿办的就差不多了，但是还有一个问题，就是这种情况下，数据库还是没有准备的状态
所以如果在这种情况下，对数据库进行读写操作那就是500等着你。

那么现在应该干什么呢。

照我说的做就OK

1.在工程文件中加入我画框的这句话

<DotNetCliToolReference Include="Microsoft.EntityFrameworkCore.Tools.DotNet" Version="1.0.0" />

2.在此工程文件夹下启动cmd，执行 dotnet ef migrations add InitialCreate指令

3.用nuget给工程加入Microsoft.EntityFrameworkCore.Tools类库，这样咱们就能在PMC当中，输入操作db的指令了

4.执行Update-datebase
成功之后，环境基本就OK了，就可以继续开发了。

如果这篇文章对您有帮助，我深表荣幸。