1. CPLEX 读取 MPS 文件报错，问题到底出在哪

MPS 文件是数学规划领域最通用的模型交换格式之一，CPLEX、Gurobi、GAMS、SCIP 这些求解器都能读。它的结构看起来很简单：NAME、ROWS、COLUMNS、RHS、BOUNDS、ENDATA 六个段，用固定列宽或自由格式描述一个线性规划模型。但真正上手时，很多人第一次用 CPLEX 读 MPS 就会撞上报错，比如CPLEX Error 1615: Line 12: Expected a number或者Error 1422: Unknown section，甚至读进去了却提示infeasible，查半天发现是 RHS 段写错了。

这类问题的根源通常不在 CPLEX 本身，而在 MPS 文件的格式细节。MPS 有两种格式：固定格式（fixed format）要求每列严格对齐，自由格式（free format）用空格分隔。CPLEX 默认按固定格式解析，如果你的文件是用文本编辑器手写的、列没对齐，就会在第 2 列被当成行名、第 5 列被当成系数时直接崩掉。另一个高频坑是 ROWS 段里目标函数行必须标N，而且只能有一个N行；COLUMNS 段里同一个变量的系数如果超过两个约束，必须换行继续写，不能一行塞三个。

我试过用 CPLEX 命令行读一个从 Excel 导出的 MPS，报错指向第 8 行，实际原因是导出时用了制表符而不是空格，固定格式解析器把制表符当成了非法字符。这类问题靠肉眼很难定位，因为报错行号往往和真实错误位置差几行。

所以排查 MPS 读取问题，需要两件事：一是搞清楚 CPLEX 的解析规则和常见报错含义，二是有一个能快速做格式预检的手段。前者靠文档和经验，后者可以用 TaoToken 统一 Key 通道调用 API 做格式校验，把 MPS 文本丢进去让模型按规则逐段检查，比反复改文件试错快得多。下面我会先讲 MPS 各段的硬性规则和检查清单，再给 CPLEX 命令行读取的完整示例，最后给通过 TaoToken 做格式预检的配置片段和验证步骤。

2. TaoToken 前置准备：统一 Key 与 MPS 格式预检通道

在讲具体配置之前，先说清楚 TaoToken 在这个场景里扮演什么角色。它不是一个求解器，也不替代 CPLEX，而是一个统一的 API Key 通道。你注册后拿到一个 Key，就能通过同一个入口调用多种模型，用来做 MPS 文件的格式预检、报错解释、字段对照。对于本地求解环境搭建来说，这解决了一个很实际的问题：你不需要为每个小工具单独申请 Key、单独配环境变量，一个 Key 走通所有格式校验和文档查询。

TaoToken 的官网是 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，API 入口是 https://taotoken.net/api 。注意 API 地址不带 UTM 参数，配置时直接用这个。

前置准备分三步。第一步，在官网注册账号，进入控制台创建 API Key。控制台地址是 https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_content=console&utm_campaign=rewrite ，API Keys 管理页在 https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api-keys&utm_campaign=rewrite 。创建后复制 Key，形如sk-开头的一串字符，只显示一次，记得存好。

第二步，确认你要用的模型 ID。TaoToken 支持多种模型，做 MPS 格式预检建议用长上下文、擅长结构化文本的模型。你可以在模型对话页 https://taotoken.net/chat?utm_source=taotoken_aicg_blog_end&utm_content=chat&utm_campaign=rewrite 先试一下，把一段 MPS 贴进去问「这段 ROWS 段有没有语法错误」，看返回质量再决定用哪个模型 ID。

第三步，把 Key 和 Base URL 配到本地环境。如果你用命令行工具或脚本调用，建议写成环境变量，避免硬编码。Linux/macOS 下：

export TAOTOKEN_API_KEY="sk-你的Key" export TAOTOKEN_BASE_URL="https://taotoken.net/api"

Windows PowerShell：

$env:TAOTOKEN_API_KEY="sk-你的Key" $env:TAOTOKEN_BASE_URL="https://taotoken.net/api"

这里要强调一点：TaoToken 的 Base URL 是https://taotoken.net/api，不要加/v1后缀，也不要加 UTM 参数。很多 401 报错就是因为 Base URL 写成了带/v1或者带了查询参数，导致鉴权路径不对。

如果你用的是 Claude Code 这类编码工具做辅助排查，可以在其配置里指定 Base URL 和 Key，模型 ID 填你选定的那个。Claude Code 的接入文档在 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite ，里面有完整的 settings 配置示例。对于长期做数学规划建模、需要反复校验 MPS 的场景，也可以考虑 Coding Plan，地址是 https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding-plan&utm_campaign=rewrite ，适合高频调用。

前置准备做完，你手里应该有一个可用的 Key、一个确定的模型 ID、一个配好的 Base URL。接下来进入 MPS 格式本身的检查清单和 CPLEX 读取示例。

3. 可复制配置：MPS 字段检查清单与 CPLEX 读取命令

这一节给两份可直接复制的东西：一份 MPS 文件头和各段的字段检查清单，一份 CPLEX 命令行读取示例，再加一段 TaoToken 做格式预检的配置片段。

先看 MPS 文件的标准结构。以一个最小可读的 MPS 为例：

NAME example.mps ROWS N obj L c1 L c2 G c3 L c4 COLUMNS x1 obj -1.0 c1 -1.0 x1 c2 1.0 c3 3.0 x2 obj -2.0 c1 1.0 x2 c2 -3.0 c3 2.0 x3 obj -3.0 c1 1.0 x3 c2 1.0 c3 -1.0 x3 c4 1.0 x4 c4 -4.0 RHS rhs c1 20.0 c2 30.0 rhs c3 100.0 c4 40.0 BOUNDS UP bnd x1 40.0 LO bnd x2 10.0 UP bnd x3 100.0 ENDATA

对照这份文件，检查清单如下。NAME 段：第一行必须是NAME加文件名，文件名可省略但不能有空格。ROWS 段：每行第一个非空字符是行类型，N表示自由行（目标函数行），L表示小于等于，G表示大于等于，E表示等于；N行有且只能有一个；行名不能重复。COLUMNS 段：每行描述一个变量在两个约束里的系数，格式是「变量名 行名1 系数1 行名2 系数2」；同一个变量如果出现在超过两个约束里，必须另起一行继续写；系数不能省略，写0也要写出来。RHS 段：格式是「RHS名 行名1 值1 行名2 值2」，RHS 名可以任意但同一文件里要一致；没写的行默认右端项为 0。BOUNDS 段：UP是上界，LO是下界，FX是固定值，FR是自由变量；默认下界是 0，默认上界是正无穷；如果变量需要负下界，必须显式写LO或FR。ENDATA 段：文件最后一行必须是ENDATA，后面不能有内容。

固定格式下，各字段的列位置是：第 2-3 列是段标识，第 5-12 列是字段1，第 15-22 列是字段2，第 25-36 列是字段3，第 40-47 列是字段4，第 50-61 列是字段5。自由格式下用空格分隔，CPLEX 也能读，但要求段标识单独一行。如果你手写 MPS，建议用自由格式，避免列对齐的麻烦。

CPLEX 命令行读取 MPS 的完整示例。假设你已经装好 CPLEX，cplex可执行文件在 PATH 里。交互式读取：

cplex

进入 CPLEX 交互界面后：

CPLEX> read example.mps CPLEX> display problem statistics CPLEX> optimize CPLEX> display solution variables -

如果只想验证读取是否成功，不求解，可以用：

CPLEX> read example.mps CPLEX> display problem

非交互式一行命令：

cplex -c "read example.mps" "display problem statistics" "quit"

如果读取报错，CPLEX 会输出类似CPLEX Error 1615: Line 12: Expected a number的信息。这时候把报错行号和 MPS 文件对照，重点看该行的列对齐和字段数量。

接下来是 TaoToken 做格式预检的配置片段。你可以写一个 Python 脚本，把 MPS 文件内容读出来，通过 TaoToken API 发给模型，让它按上面的检查清单逐段校验。配置文件用 JSON 存参数：

{ "base_url": "https://taotoken.net/api", "api_key_env": "TAOTOKEN_API_KEY", "model": "你的模型ID", "timeout": 60, "max_tokens": 2048 }

Python 调用片段：

import os import json import requests with open("taotoken_config.json", "r", encoding="utf-8") as f: cfg = json.load(f) api_key = os.environ.get(cfg["api_key_env"]) headers = { "Authorization": f"Bearer {api_key}", "Content-Type": "application/json" } with open("example.mps", "r", encoding="utf-8") as f: mps_text = f.read() prompt = f"""请按以下检查清单逐段校验这个 MPS 文件，指出每一段的错误行号和原因： 1. NAME 段格式 2. ROWS 段：N 行是否唯一，行类型是否合法 3. COLUMNS 段：每行字段数，同一变量是否超过两个约束未换行 4. RHS 段：格式和默认值 5. BOUNDS 段：上下界类型 6. ENDATA 是否在最后 MPS 内容： {mps_text} """ payload = { "model": cfg["model"], "messages": [{"role": "user", "content": prompt}], "max_tokens": cfg["max_tokens"] } resp = requests.post( f"{cfg['base_url']}/chat/completions", headers=headers, json=payload, timeout=cfg["timeout"] ) print(resp.status_code) print(resp.json()["choices"][0]["message"]["content"])

注意base_url是https://taotoken.net/api，请求路径拼/chat/completions。如果你的模型 ID 或路径不对，会返回 404 或 401，排查方法见第 5 节。

4. 验证请求：从 MPS 读取到求解结果跑通

配置写完，要验证整条链路能跑通。验证分两层：先验证 TaoToken 的格式预检请求能返回结果，再验证 CPLEX 能成功读取并求解。

先验证 TaoToken 请求。把上面的 Python 脚本保存为check_mps.py，确保example.mps和taotoken_config.json在同一目录，环境变量TAOTOKEN_API_KEY已设置。运行：

python check_mps.py

预期输出：HTTP 状态码 200，然后是一段中文分析，指出 MPS 各段是否合规。如果模型返回「ROWS 段第 3 行 N 行合法，COLUMNS 段第 8 行 x3 出现三个约束系数但已换行，合规」这类内容，说明预检通道通了。如果返回 401，看第 5 节。

再验证 CPLEX 读取。用第 3 节那份example.mps，运行：

cplex -c "read example.mps" "display problem statistics" "optimize" "display solution variables -" "quit"

预期输出会包含问题统计，比如：

Problem statistics: Variables: 4 Constraints: 4 Nonzeros: 12

然后 optimize 会输出求解状态，比如Optimal solution found，以及目标函数值和各变量取值。如果读取阶段就报错，说明 MPS 格式有问题，回到第 3 节检查清单逐段核对。

这里有个实用技巧：CPLEX 读取 MPS 时可以用set read相关参数控制格式解析。比如强制按自由格式读：

CPLEX> set read mps_format free CPLEX> read example.mps

或者查看当前读取设置：

CPLEX> display read

如果你的 MPS 是从其他工具导出的，格式可能介于固定和自由之间，用set read mps_format free往往能绕过列对齐问题。但要注意，自由格式下段标识必须单独一行，且字段之间用空格分隔，不能有制表符。

验证成功后，你应该能看到 CPLEX 输出最优解，同时 TaoToken 的预检报告没有报出致命错误。这两步都通过，说明 MPS 读取流程跑通了。如果只通了预检但 CPLEX 还报错，说明预检清单没覆盖到某个细节，把 CPLEX 的报错信息贴回给模型，让它针对性分析。

对于需要反复调试多个 MPS 文件的场景，可以把预检脚本改成批量模式，遍历目录下所有.mps文件，逐个调用 TaoToken 校验，输出一份汇总报告。这样在跑 CPLEX 之前就能筛掉大部分格式错误，省去反复读文件试错的时间。

5. 本篇常见错排查：401、local proxy failed、reading choices、OAuth

这一节对照真实报错，给排查路径。这些报错在 MPS 格式预检和 CPLEX 读取场景里都可能遇到。

401 Unauthorized。这是 TaoToken 调用最常见的错。原因通常有三个：Key 没设置或设置错、Base URL 写错、请求头格式不对。先检查环境变量：

echo $TAOTOKEN_API_KEY

如果输出为空，说明没设置。如果输出有值但请求还是 401，检查 Base URL 是不是https://taotoken.net/api，不要带/v1，不要带 UTM 参数。请求头必须是Authorization: Bearer sk-xxx，Bearer 和 Key 之间一个空格。如果 Key 是从控制台复制的，注意有没有多余空格或换行。还有一种情况是 Key 被禁用或额度用完，去控制台 https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api-keys&utm_campaign=rewrite 确认状态。

local proxy failed。这个报错说明请求没发出去，卡在本地网络层。常见原因是本地配了代理但代理不可用，或者环境变量HTTP_PROXY/HTTPS_PROXY指向了一个失效的地址。检查：

env | grep -i proxy

如果有输出，临时清掉：

unset HTTP_PROXY HTTPS_PROXY

然后重试。如果你在公司网络里，可能需要走内部代理，那就确认代理地址和端口正确。注意，这里说的是本地网络配置问题，不涉及任何绕过网络限制的操作，只是确保请求能正常到达 API 入口。

reading choices 相关报错。这个通常出现在解析 API 返回时，比如KeyError: 'choices'或list index out of range。原因是返回的 JSON 结构和你预期的不一样。先打印完整返回：

print(resp.status_code) print(resp.text)

如果返回的是错误信息而不是正常结构，说明请求本身失败了，先解决 401 或 404。如果返回正常但choices为空，可能是模型 ID 写错，或者max_tokens设得太小导致没有输出。检查模型 ID 是否和控制台里的一致，max_tokens至少设 256。

OAuth 相关报错。如果你用 Claude Code 或其他编码工具接入，可能会遇到 OAuth 认证失败。这类工具通常有自己的认证流程，接入 TaoToken 时要在配置里指定 Base URL 和 Key，而不是走它默认的 OAuth。Claude Code 的配置文档在 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite ，里面有 settings 文件的完整写法。关键三件套：Base URL 填https://taotoken.net/api，Key 填你的sk-Key，Model ID 填你选定的模型。三个都写全，缺一个就会认证失败。

如果你用 CC Switch 或 Cline MCP 这类工具，同样要写全三件套。CC Switch 的配置里，Base URL、Key、Model ID 分别对应不同字段，不要只填 Key 就以为能通。Cline MCP 的配置在 MCP server 设置里，Base URL 和 Key 要填在环境变量或配置项里。Codex 的auth.json里也要写全这三项，格式参考文档。

还有一个容易忽略的错：CPLEX 读取 MPS 时报CPLEX Error 1422: Unknown section。这不是 TaoToken 的问题，是 MPS 文件里出现了 CPLEX 不认识的段标识。检查文件里有没有拼错的段名，比如RHS写成RHS带尾随空格，或者BOUNDS写成BOUND。固定格式下段标识必须在第 2-3 列，自由格式下必须单独一行且拼写完全正确。

排查顺序建议：先确认 TaoToken 请求通（401 解决），再确认 MPS 格式预检返回正常（reading choices 解决），最后确认 CPLEX 读取无报错（1422 解决）。每一步的报错信息都保留，贴给模型做针对性分析，比盲目改文件高效。

6. 用统一 Key 把 MPS 排查流程固定下来

MPS 文件读取报错这件事，本质是格式规则多、报错信息不直观、试错成本高。CPLEX 的报错行号经常和真实错误位置有偏差，手写 MPS 时列对齐和字段数量又容易出错。把 TaoToken 的格式预检加进流程，相当于在跑求解器之前先做一遍静态检查，能拦下大部分低级错误。

具体做法可以固定成三步。第一步，写完或导出 MPS 后，先跑预检脚本，让模型按检查清单逐段核对，输出错误行号和原因。第二步，根据预检报告改文件，改完再跑一次预检，直到没有致命错误。第三步，用 CPLEX 读取并求解，如果还有报错，把报错信息和 MPS 片段一起发给模型，让它定位。

这套流程的关键是统一 Key。你不需要为预检、文档查询、报错分析分别配不同的 Key 和 Base URL，一个 TaoToken Key 走通全部。配置片段里的base_url固定为https://taotoken.net/api，模型 ID 按需切换。对于长期做数学规划建模的人，可以把预检脚本做成命令行工具，传入 MPS 文件路径就输出检查报告，集成到建模工作流里。

最后给一个实用技巧：CPLEX 读取 MPS 时，如果文件很大，报错行号可能不直观。可以先用set read mps_format free强制自由格式读一遍，如果自由格式能读进去，说明是列对齐问题；如果自由格式也报错，说明是字段内容问题，比如系数写了非数字字符。这个二分法能快速缩小问题范围。配合 TaoToken 的预检报告，基本能在几分钟内定位到具体行和具体字段。