Troubleshooting network analyses
In the ArcGIS Network Analyst extension, you may encounter certain error messages or unexpected behaviors that you want to understand and resolve. It is helpful to turn on error and warning messages on the Network Analyst Options dialog box.
You can open the Network Analyst Options dialog box by clicking Network Analyst > Options on the Network Analyst toolbar.
Learn more about Network Analyst options
You can refer to the general behavior section below to understand what kinds of errors are reported by Network Analyst and why they occur.
Additionally, the solverspecific behavior section below discusses how Network Analyst solvers behave in different scenarios, for example, what happens during a route analysis when the first stop is not located on the network.
General behavior
There are five kinds of errors reported by Network Analyst, as discussed in the table below. The order in which these errors are discovered is as follows:
 Errors in definition
 Invalid locations
 Cardinality issues
 Reachability issues
 User aborted
Type of issue 
Description 
Example 
Output 

Errors in definition 
The analysis problem is incorrectly defined. 

An error message is generated. No solution is found. 
Invalid locations 
Some or all of the network locations are not located on the network. In such cases, two alternatives exist:


If invalid locations are ignored, a partial solution is found using the located network locations. Additionally, a warning message is generated about the unlocated network locations that were ignored. If invalid locations are not ignored, no solution is found, and an error message is generated. 
Cardinality issues 
The number of valid locations is fewer than the minimum number of locations required for the analysis. 
During route analysis, there is only one valid network location. 
An error message is generated. No solution is found. 
Reachability issues 
Some of the network locations cannot be reached. 

Output depends on the solver and the analysis settings. In some cases, a partial solution with a warning message is found. In other cases, no solution is found, and an error message is generated. 
User aborted 
The user aborts the analysis by pressing the ESC key. 
During route analysis, the user presses the ESC key, after clicking the Solve button and before the analysis is complete. 
An abort message is generated. 
Solverspecific behavior
The following rules apply to each solver:
Route solver
 At least two stops per route are required to solve.
 No solution if no route is found.
 If invalid locations are set to be ignored, all invalid locations are ignored (stops as well as barriers). Additionally, the sequence number of all stops is not changed (unless the Reorder Stops To Find Optimal Route analysis layer option is used).
 If you have valid stops and one of them is unreachable, no solution is found to any stop (unless the Reorder Stops To Find Optimal Route option is used).
 The sequence number must be valid. That is, it must be greater than zero and cannot exceed the number of stops nor be a duplicate value.
Route solver using the Reorder Stops To Find Optimal Route option
 If invalid locations are set to be ignored, all invalid locations are skipped. The stops are resequenced such that the invalid locations are moved to the end of the list. If the first stop is an invalid location, the second stop becomes the first one, and the first stop is moved to the end of the list.
 If you have valid stops and one of them is unreachable, the stops are reordered and the unreachable stop is moved to the end of the list. A partial solution is found. This means the route is calculated for the reachable, valid stops.
 If the analysis layer option Preserve First Stop (or Preserve Last Stop) is checked, the first stop (or the last stop) must be reachable. If it is unreachable, no solution is found.
Closest facility solver
 At least one valid, reachable incident and one valid, reachable facility are required to solve.
 If there is no valid or reachable facility for any incident, no solution is found.
 If there are some incidents that have no valid or reachable facility, a partial solution is found, as long as at least one valid, reachable incident and one valid, reachable facility are present.
 If invalid locations are set to be ignored, all invalid locations are ignored (facilities, incidents, and barriers).
Service area solver
 At least one valid, reachable facility is required to solve.
 If there are no traversable edges for any facility, no solution is found.
 If there are some facilities with no traversable edges, a partial solution is found—as long as there exists at least one facility with traversable edges.
 If invalid locations are set to be ignored, all invalid locations are ignored (facilities and barriers).
OD cost matrix solver
 At least one valid, reachable origin and one valid, reachable destination are required to solve.
 If there is no valid or reachable destination for any origin, no solution is found.
 If there are some origins with no valid or reachable destinations, a partial solution is found—as long as there exists at least one valid and reachable destination for at least one valid and reachable origin.
 If invalid locations are set to be ignored, all invalid locations are ignored (origins, destinations, and barriers).
Vehicle routing problem solver
 At least one order, depot, and route are required for a given vehicle routing problem analysis layer to be solved.
 The invalid network locations in Orders, Depots, and Barriers network analysis classes cannot be ignored. An error message is generated if any of these network analysis classes have invalid network locations.
 The attributes in the network analysis classes that act as key fields must have identical values. For example, the value for the Name attribute in the Depots network analysis class must be identical to the value for the StartDepotName and EndDepotName attributes in the Routes network analysis class. Similarly, the value for the Name attribute in the Routes network analysis class must be identical to the value for the RouteName attribute in the Breaks network analysis class.
Relationships between network analysis classes in the vehicle routing problem
 If distancebased constraints, such as MaxTotalDistance and CostPerUnitDistance, are specified for routes, the Distance Attribute property of the analysis layer has to be specified.
 If the VRP solver cannot assign all the orders to the routes without violating the given constraints, a partial solution is determined by the solver. The ViolatedConstraints attribute in the Orders and Routes network analysis classes contains information about the constraints that are violated by a particular order or the route.
Locationallocation solver
 At least one valid, reachable facility and one valid, reachable demand point are required to solve.
 If there isn't a valid, reachable facility or demand point, no solution is found.
 If there are some facilities on nontraversable edges, a partial solution is found—as long as there exists at least one facility with traversable edges.