# 江科HIS - 端口冲突解决方案

## 🚨 问题描述

在启动江科HIS读卡服务时遇到以下错误：
```
System.Reflection.TargetInvocationException: 调用的目标发生了异常
HttpListenerException: 在创建 'http://localhost:8321/' 上的新失败，因为与计算机上的微信注册冲突
```

## 🔍 问题原因

**端口8321被其他程序占用**，常见的占用程序包括：
- **微信** (最常见)
- **QQ**
- **其他医疗软件**
- **Web开发工具**

## ✅ 解决方案

### 方案1: 管理员权限运行（推荐）

**原因：** 保持8321端口不变，确保与其他项目的兼容性。

1. **使用提供的批处理文件：**
   ```bash
   双击运行：以管理员身份启动江科HIS.bat
   ```

2. **手动以管理员身份运行：**
   - 右键点击 `ThCardReader.exe`
   - 选择"以管理员身份运行"

### 方案2: 关闭占用端口的程序

1. **关闭微信：**
   - 完全退出微信（托盘图标右键->退出）
   - 确保微信开发者工具也已关闭

2. **检查其他程序：**
   ```cmd
   netstat -aon | findstr ":8321"
   ```
   找到占用进程ID后，在任务管理器中结束该进程

### 方案3: 检查和释放端口

1. **使用端口检查工具：**
   ```bash
   双击运行：check_port.bat
   ```

2. **手动检查端口占用：**
   ```cmd
   netstat -aon | findstr ":8321"
   ```

3. **结束占用进程（谨慎操作）：**
   ```cmd
   taskkill /PID [进程ID] /F
   ```

### 方案4: 重启计算机

如果上述方案都无效，重启计算机可以释放所有被占用的端口。

## 🔧 验证解决方案

启动程序后应该看到：
```
江科HIS读卡服务已成功启动。
服务地址: http://localhost:8321
```

**测试接口：**
```
http://localhost:8321/api/entry?param=jiangsu_qrcode_01101
http://localhost:8321/readcard/jiangsu/status
```

## 📋 常见问题

### Q1: 为什么微信会占用8321端口？
**A:** 微信的某些功能（如小程序开发工具）可能会使用8321端口进行本地调试。

### Q2: 如何确认端口是否可用？
**A:** 运行 `check_port.bat` 或在命令行执行：
```cmd
netstat -aon | findstr ":8321"
```
如果没有输出，说明端口可用。

### Q3: 程序启动后还是报错怎么办？
**A:** 按顺序检查：
1. 确认使用管理员权限运行
2. 完全关闭微信等占用端口的程序
3. 检查防火墙设置
4. 确认江苏医保DLL文件存在
5. 重启计算机释放端口

### Q4: 为什么不改用其他端口？
**A:** 因为其他项目（如医院信息系统）也在使用8321端口的接口，改变端口会影响现有系统的正常运行。

### Q5: 如何预防端口冲突？
**A:** 
1. 使用专用的开发/部署环境
2. 启动江科HIS前关闭微信等应用
3. 使用管理员权限运行
4. 定期检查端口使用情况

## 🛠️ 技术细节

### 增强的错误处理

**RestService.cs 修改：**
```csharp
try
{
    srvcobj = WebApp.Start<Startup>("http://localhost:8321");
    MessageBox.Show("江科HIS读卡服务已成功启动。\n服务地址: http://localhost:8321");
}
catch (Exception ex)
{
    // 检查是否是端口占用问题
    if (ex.Message.Contains("8321") || ex.Message.Contains("微信") || ex.Message.Contains("冲突"))
    {
        var result = MessageBox.Show(
            "端口8321被占用（可能是微信等程序）！\n\n" +
            "解决方案:\n" +
            "1. 关闭微信等占用端口的程序\n" +
            "2. 以管理员身份运行本程序\n" +
            "3. 重启计算机释放端口\n\n" +
            "是否打开端口检查工具？", 
            "端口占用冲突", 
            MessageBoxButtons.YesNo, 
            MessageBoxIcon.Warning);
        
        if (result == DialogResult.Yes)
        {
            System.Diagnostics.Process.Start("check_port.bat");
        }
    }
    throw;
}
```

## 🚀 部署建议

### 生产环境部署
1. **使用专用服务器**：避免与其他应用冲突
2. **配置防火墙**：开放8321端口
3. **管理员权限**：确保服务以管理员权限运行
4. **监控工具**：定期检查端口状态

### 开发环境配置
1. **关闭不必要的应用**：特别是微信、QQ等
2. **使用独立环境**：虚拟机或容器
3. **端口管理**：记录并管理使用的端口

## 📞 技术支持

如果上述方案都无法解决问题，请联系技术支持并提供：

1. **错误截图**
2. **端口检查结果** (`check_port.bat` 输出)
3. **系统信息** (Windows版本、.NET Framework版本)
4. **详细错误日志**
5. **当前运行的程序列表**

---

**更新时间：** 2024年最新版本  
**适用版本：** 江科HIS v1.0+  
**技术栈：** C# .NET Framework, OWIN, WebAPI  
**端口：** 8321 (固定，确保兼容性)