Files
x-server-mobile/dev/已知问题和解决方案.md
T

56 lines
1.4 KiB
Markdown
Raw Normal View History

2026-02-24 23:44:40 +08:00
# 前端开发已知问题和解决方案
## 1. antd-mobile-icons 导入错误
**问题**: `The requested module '/node_modules/.vite/deps/antd-mobile-icons.js' does not provide an export named 'PlusOutline'`
**原因**: antd-mobile-icons 中没有 `PlusOutline` 图标
**解决方案**: 使用正确的图标名称:
- `PlusOutline` → `AddOutline`
- 可通过查看 `node_modules/antd-mobile-icons/es/index.d.ts` 确认可用的图标
## 2. DatePicker 组件报错
**问题**: `Cannot read properties of null (reading 'getTime')`
**原因**: DatePicker 组件的 `min` 或 `max` 属性接收到了 `null` 值
**解决方案**: 使用条件展开运算符,只在值存在时传递属性:
```tsx
// 错误写法
<DatePicker min={startDate || undefined} />
// 正确写法
<DatePicker {...(startDate && { min: startDate })} />
```
## 3. 端口占用问题
**问题**: Vite 启动时端口被占用,自动尝试其他端口
**解决方案**: 清理旧进程后重启
```bash
ps aux | grep vite | grep -v grep | awk '{print $2}' | xargs -r kill -9
```
## 4. 防火墙规则
**问题**: 外网无法访问开发服务器
**解决方案**: 添加防火墙规则
```bash
iptables -I INPUT -p tcp --dport 5173 -j ACCEPT
```
## 5. Vite 配置
确保 `vite.config.ts` 中配置正确的 host:
```ts
server: {
port: 5173,
host: '0.0.0.0', // 允许外网访问
proxy: { ... }
}
```