.NetCore WebAPI采坑之路(持续更新)

提示：扫一扫查出行
【扫一扫了解最新限行尾号】
复制提示

1、WebAPI新增日志过滤器or中间件后Action读取到的请求Body为空问题

案例:

自定义了一个中间件，用于记录每次访问webapi的入参，以及引用了Swagger。

先看下面这段代码:

public void Configure(IApplicationBuilder app, IHostingEnvironment env)
{
if (env.IsDevelopment())
{
app.UseDeveloperExceptionPage();
}
else
{
app.UseHsts();
}
app.UseMvc(); //各种中间件
app.UseVisitLogger();
app.UsAirExceptionHandler();
app.UseHttpsRedirection();
//SignalR
app.UseSignalR(routes =>
{
routes.MapHub<TriageHub>("/triage", (options) =>
{
//指定采取WebSoket协议进行双工通讯
options.Transports = Microsoft.AspNetCore.Http.Connections.HttpTransportType.WebSockets;
});
}); //swagger
app.UseSwagger();
app.UseSwaggerUI(c => c.SwaggerEndpoint("/swagger/v1/swagger.json", "TestWebAPI"));
}

上面这段代码看上去是不是人畜无害，没啥问题。恩，F5启动后，我们试下执行post方式的webapi。执行结果是ok的，但是UseVisitLogger中间件里的

日志记录却没有记录webapi的访问日志。

我们把Startup下的Configure方法改成下面这种方式:

public void Configure(IApplicationBuilder app, IHostingEnvironment env)
{
if (env.IsDevelopment())
{
app.UseDeveloperExceptionPage();
}
else
{
app.UseHsts();
}
//各种中间件
app.UseVisitLogger();
app.UsAirExceptionHandler();
app.UseHttpsRedirection();
//SignalR
app.UseSignalR(routes =>
{
routes.MapHub<TriageHub>("/triage", (options) =>
{
//指定采取WebSoket协议进行双工通讯
options.Transports = Microsoft.AspNetCore.Http.Connections.HttpTransportType.WebSockets;
});
});
app.UseMvc();
//swagger
app.UseSwagger();
app.UseSwaggerUI(c => c.SwaggerEndpoint("/swagger/v1/swagger.json", "TestWebAPI"));
}

我们把UseMvc()放置各类中间件的后面，再来试下webapi的post方式(post的入参是一个模型，不是基础数据类型!)

执行结果如上图。。。这一次api执行失败，但是日志记录成功了，如下图:

哎。。。是不是很坑。。目前先记录下，还要想办法怎么去解决

---------------------------------------------------------------------解决新增自定义中间件后执行带模型Post请求400问题----------------------------------

原因: 因为自定义中间件里有一个是写日志的，会将HttpContext对象的Request.Body对象(一个Steam对象)的读取位置改变。原来的日志中间件是这样写的，如下:

上面的 requst.Body 在通过ReadToEnd后实际上的context.Request.Body的读取位置已经是最后了，在后续的中间件接收到的context因为读取位置不是0而是内容的

长度，所以怎么都读不到数据。这就是为什么post请求会出现400错误，因为到action那里的时候确实Requst.Body的内容他啥也没读到啊！！

现在找到了问题所在就好处理了，处理方式如下:

public async Task Invoke(HttpContext context)
{
visitLog = new VisitLog();
HttpRequest request = context.Request;
visitLog.Url = request.Path.ToString();
visitLog.Headers = request.Headers.ToDictionary(k => k.Key, v => string.Join(";", v.Value.ToList()));
visitLog.Method = request.Method;
visitLog.ExcuteStartTime = DateTime.Now;
var originalRequestBody = request.Body; var requestBodyStream = new MemoryStream();
await request.Body.CopyToAsync(requestBodyStream);
//设置当前流的位置未0
requestBodyStream.Seek(0, SeekOrigin.Begin);
//这里ReadToEnd执行完毕后requestBodyStream流的位置会从0到最后位置(即request.ContentLength)
visitLog.RequestBody = new StreamReader(requestBodyStream).ReadToEnd();
//需要将流位置重置偏移到0，不然后续的action读取不到request.Content的值
requestBodyStream.Seek(0, SeekOrigin.Begin); context.Response.OnCompleted(ResponseCompletedCallback, context);
context.Request.Body = requestBodyStream;
await _next(context);
context.Request.Body = originalRequestBody;
}

好啦，我们把流的读取位置重新偏移下就好了！

2、.NetCore项目智能提示英文更改为中文的方法

.NetCore下载后，在VS2017开发时候，智能提示是下图这样的：

很不爽是吧，尤其是我们这种英文渣。解决方案呢其实就是需要将框架里的Nuget包的注释xml文件替换成中文版的(至少我是这么做的，其他办法未知..)

首先从C:\Program Files (x86)\Reference Assemblies\Microsoft\Framework\.NETCore\v4.5.1 这个目录下将zh-Hans文件夹下的所有文件copy到

C:\Program Files\dotnet\sdk\NuGetFallbackFolder\microsoft.netcore.app\2.1.0\ref\netcoreapp2.1目录下。这里我是因为用的.NetCore2.1，如果

是2.0则将目录里的2.1更改成2.0。然后重新打开VS2017就可以发现智能提示是中文啦~~~~

3、字符集GB2312引用错误处理

在对csv文件读取时候乱码，后来发现.NetCore需要安装System.Text.Encoding.CodePages这个Nuget包，然后在类的构造函数里加上这一段代码System.Text.Encoding.RegisterProvider(System.Text.CodePagesEncodingProvider.Instance)